Freigeben über

SHPropStgWriteMultiple-Funktion (shlobj_core.h)

  • Artikel

[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.]

Umschließt die IPropertyStorage::WriteMultiple-Funktion , um sicherzustellen, dass ANSI- und Unicode-Übersetzungen für veraltete Eigenschaftssätze ordnungsgemäß verarbeitet werden.

Syntax

SHSTDAPI SHPropStgWriteMultiple(
  [in]                IPropertyStorage  *pps,
  [in, out, optional] UINT              *puCodePage,
                      ULONG             cpspec,
  [in]                PROPSPEC const [] rgpspec,
  [in, out]           PROPVARIANT []    rgvar,
                      PROPID            propidNameFirst
);

Parameter

[in] pps

Typ: IPropertyStorage*

Ein IPropertyStorage-Schnittstellenzeiger , der den Eigenschaftenspeicher identifiziert.

[in, out, optional] puCodePage

Typ: UINT*

Ein Zeiger auf den Codepagewert für ANSI-Zeichenfolgeneigenschaften.

cpspec

Typ: ULONG

Die Anzahl der eigenschaften, die festgelegt werden.

[in] rgpspec

Typ: PROPSPEC const[]

Ein Array von PROPSPEC-Strukturen, die die festzulegenden Eigenschafteninformationen enthalten.

[in, out] rgvar

Typ: PROPVARIANT[]

Ein Array von PROPVARIANT-Typen zum Festlegen der Eigenschaftswerte.

propidNameFirst

Typ: PROPID

Der Mindestwert für Eigenschaftsbezeichner, wenn sie zugeordnet werden müssen. Der Wert sollte größer oder gleich PID_FIRST_USABLE sein.

Rückgabewert

Typ: HRESULT

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h
Bibliothek Shell32.lib
DLL Shell32.dll (Version 6.0 oder höher)