ResUtilSetPropertyTable-Funktion (resapi.h)

Artikel
08/25/2023

Legt Eigenschaften in der Clusterdatenbank basierend auf einer Eigenschaftenliste aus einer Eigenschaftentabelle fest.

Syntax

DWORD ResUtilSetPropertyTable(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [out, optional] LPBYTE                       pOutParams
);

Parameter

[in] hkeyClusterKey

Clusterdatenbankschlüssel, der den Speicherort der festzulegenden Eigenschaften identifiziert.

[in] pPropertyTable

Zeiger auf ein Array von RESUTIL_PROPERTY_ITEM Strukturen, die die festzulegenden Eigenschaften beschreiben.

Reserved

Reserviert.

[in] bAllowUnknownProperties

Gibt an , ob unbekannte Eigenschaften akzeptiert werden sollen. Dieser Parameter wird auf TRUE festgelegt, wenn sie akzeptiert werden sollen, und AUF FALSE , wenn dies nicht der Fall ist.

[in] pInPropertyList

Zeiger auf den Eingabepuffer, der eine Eigenschaftenliste enthält.

[in] cbInPropertyListSize

Größe des Eingabepuffers in Byte, auf den cbInPropertyList verweist.

[out, optional] pOutParams

Zeiger auf einen Parameterblock , der zurückgegebene Daten enthält. Wenn angegeben, werden Parameter nur geschrieben, wenn sie sich von denen im Eingabepuffer unterscheiden.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode	Beschreibung
ERROR_BAD_ARGUMENTS	Mindestens einer der Eingabeparameter war ungültig.
ERROR_INSUFFICIENT_BUFFER	Die Größe des in cbInPropertyListSize angegebenen Eingabepuffers ist zu klein.
ERROR_INVALID_DATA	Der Eingabepuffer, auf den pInPropertyList verweist, ist NULL, ein Eigenschaftsname ist ungültig, oder ein Eigenschaftswert ist zu klein.
ERROR_INVALID_PARAMETER	Die Syntax, das Format oder der Typ einer Eigenschaft in der Eigenschaftentabelle, auf die von pPropertyTable verwiesen wird, ist falsch, oder eine Eigenschaft ist schreibgeschützt und kann nicht festgelegt werden.

Hinweise

Wenn ein in der Eigenschaftentabelle angegebener Wert bereits in der Clusterdatenbank vorhanden ist, wird der Wert nicht geschrieben. Informationen zum Erzwingen aller Werte zum Schreiben finden Sie unter ResUtilSetPropertyTableEx.

Rufen Sie ResUtilSetPropertyTable nicht über die folgenden Ressourcen-DLL-Einstiegspunktfunktionen auf.

ResUtilSetPropertyTable kann von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder aus einem Workerthread sicher aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.lib
DLL	ResUtils.dll

Weitere Informationen

RESUTIL_PROPERTY_ITEM

ResUtilSetPropertyTableEx

Freigeben über