IMoniker::IsSystemMoniker

HRESULT IMoniker::IsSystemMoniker(pdwMksys)7.

Answer as to whether this moniker is a type of moniker whose particular implementation semantics are conceptually important to the binding process. The values returned through pdwMksys are taken from the following enumeration:


typedef enum tagMKSYS {
    MKSYS_NONE = 0,
    MKSYS_GENERICCOMPOSITE = 1,
    MKSYS_FILEMONIKER = 2,
    MKSYS_ANTIMONIKER = 3,
    MKSYS_ITEMMONIKER = 4,
    MKSYS_POINTERMONIKER = 5,
    } MKSYS;

All user implementations of this function must simply return MKSYS_NONE through pdwMksys. IMoniker::GetClassID (see IPersist) can be used instead by non-system monikers to check for the presence of their own "special" moniker on the right in IMoniker::ComposeWith. Alternatively, use QueryInterface to test for the presence of your own private interface.

New values of this enumeration may be defined in the future; callers of this function should be aware of this fact and should therefore explicitly test against known return values that they care about (rather than, for example, assuming that if the returned value is not one of the values listed here then it's the other).

The returned value is not a bit field value; rather it is an integer.

Argument

Type

Description

pdwMksys

DWORD*

The place at which the result is to be returned. May not be NULL.

return value

HRESULT

S_OK