SHPropStgCreate-Funktion (shlobj_core.h)

[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar.]

Stellt die ordnungsgemäße Behandlung des Codepageabrufs oder der Zuweisung für den angeforderten Eigenschaftensatzvorgang sicher.

Syntax

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

Parameter

[in] psstg

Typ: IPropertySetStorage*

Ein Zeiger auf eine IPropertySetStorage-Schnittstelle .

[in] fmtid

Typ: REFFMTID

Eine zu öffnende Eigenschaftensatz-ID. Die Werte für diesen Parameter können entweder einer der Werte sein, die in vordefinierten Eigenschaftssatzformatbezeichnern oder einer anderen FMTID definiert sind, die Sie registrieren.

[in, optional] pclsid

Typ: const CLSID*

Ein Zeiger auf die CLSID, die dem Satz zugeordnet ist. Dieser Parameter kann NULL sein.

grfFlags

Art: DWORD

Ein oder mehrere Member der PROPSETFLAG-Enumeration , die bestimmen, wie der Eigenschaftensatz erstellt und geöffnet wird. Alle Sätze, die ANSI-Bytes enthalten, sollten mit PROPSETFLAG_ANSI erstellt werden, andernfalls PROPSETFLAG_DEFAULT.

grfMode

Art: DWORD

Die Flags aus der STGM-Enumeration , die Bedingungen zum Erstellen und Löschen des Objekt- und Zugriffsmodus für das Objekt angeben. Muss STGM_DIRECT enthalten | STGM_SHARE_EXCLUSIVE.

dwDisposition

Art: DWORD

Einer der folgenden Werte, definiert in Fileapi.h.

CREATE_NEW (1)

Erstellen Sie eine neue Gruppe, wenn noch keine vorhanden ist.

CREATE_ALWAYS (2)

Erstellen Sie immer einen neuen Satz, und überschreiben Sie alle vorhandenen Sätze.

OPEN_EXISTING (3)

Öffnen Sie die vorhandene Gruppe.

OPEN_ALWAYS (4)

[out] ppstg

Typ: IPropertyStorage**

Wenn diese Methode zurückgibt, enthält einen IPropertyStorage-Schnittstellenzeiger .

[out, optional] puCodePage

Typ: UINT*

Wenn diese Methode zurückgibt, enthält die Adresse der Codepage-ID für den Satz.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen