The IParseDisplayName interface parses a displayable name string to convert it into a moniker for custom moniker implementations. Display name parsing is necessary when the end user inputs a string to identify a component, as in the following situations:
Compound document applications that support links to embedded components or to pseudo-objects within their documents must provide an implementation of the IOleItemContainer interface, which is derived indirectly from IParseDisplayName. In effect, such a compound document is providing a namespace for identifying its internal components; and its IOleItemContainer implementation (which includes the IParseDisplayName implementation) is the interface through which another application can access this namespace. Alternatively, the compound document application can implement IParseDisplayName as part of its class object, which is accessible through the CoGetClassObject function.
Monikers that support their own namespace with custom requirements for parsing names also implement this interface.
If you are implementing your own moniker class, you might need to use this interface from your implementation of IMoniker::ParseDisplayName. If you call the MkParseDisplayName or the MkParseDisplayNameEx functions, you are indirectly using IParseDisplayName. These two functions call IParseDisplayName to parse display names for objects that provide custom moniker implementations.
| IUnknown Methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| IParseDisplayName Method | Description |
|---|---|
| ParseDisplayName | Parses the display name returning a moniker corresponding to it. |
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in oleidl.h.
IMoniker::ParseDisplayName, IOleItemContainer, MkParseDisplayName, MkParseDisplayNameEx