ResUtilSetPrivatePropertyList-Funktion (resapi.h)

Artikel
08/25/2023

Legt die privaten Eigenschaften eines Clusterobjekts fest.

Syntax

DWORD ResUtilSetPrivatePropertyList(
  [in] HKEY        hkeyClusterKey,
  [in] const PVOID pInPropertyList,
  [in] DWORD       cbInPropertyListSize
);

Parameter

[in] hkeyClusterKey

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

[in] pInPropertyList

Zeiger auf einen Eingabepuffer, der eine Eigenschaftenliste mit den Namen und Werten der festzulegenden Eigenschaften enthält.

[in] cbInPropertyListSize

Zeiger auf die Größe des Eingabepuffers in Byte, auf den pInPropertyList verweist.

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_INVALID_DATA	Es ist ein Problem mit der Länge der Daten einer Eigenschaft aufgetreten.
ERROR_INSUFFICIENT_BUFFER	Der Eingabepuffer, auf den pInPropertyList verweist, war NULL.
ERROR_INVALID_PARAMETER	Die Syntax eines Eigenschaftsnamens war ungültig.

Hinweise

Die Eigenschaften, die in der Hilfsprogrammfunktion ResUtilSetPrivatePropertyList festgelegt werden, werden im Teil der Clusterdatenbank unter dem angegebenen Schlüssel für das Objekt genau wie durch die Namen in der Eigenschaftenliste angegeben platziert. Wenn der Name einer Eigenschaft umgekehrte Schrägstrichzeichen (\) enthält, wird jede Zeichenfolge vor einem umgekehrten Schrägstrich als Unterschlüsselname interpretiert, und die letzte Zeichenfolge nach dem letzten umgekehrten Schrägstrich wird als Wertname interpretiert.

Rufen Sie ResUtilSetPrivatePropertyList nicht über die folgenden Ressourcen-DLL-Einstiegspunktfunktionen auf:

ResUtilSetPrivatePropertyList 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

ResUtilVerifyPrivatePropertyList

Freigeben über