ResUtilSetPropertyParameterBlock-Funktion (resapi.h)

Artikel
08/25/2023

Legt Eigenschaften in der Clusterdatenbank aus einem Parameterblock fest.

Syntax

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

Parameter

[in] hkeyClusterKey

Clusterdatenbankschlüssel, der den Speicherort für die festzulegenden Eigenschaften identifiziert.

[in] pPropertyTable

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

[in] Reserved

Reserviert.

[in] pInParams

Zeiger auf einen Eingabeparameterblock, der die Daten für die Eigenschaften enthält, die in der Eigenschaftentabelle beschrieben sind, auf die von pPropertyTable verwiesen wird.

[in] pInPropertyList

Zeiger auf den Eingabepuffer, der eine Eigenschaftsliste oder NULL enthält. Wenn pInPropertyList nicht NULL ist, werden alle in der Eigenschaftenliste aufgeführten Eigenschaften, die nicht in der Eigenschaftentabelle aufgeführt sind, auch in der Clusterdatenbank festgelegt.

[in] cbInPropertyListSize

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

[out, optional] pOutParams

Zeiger auf einen Parameterblock zum Empfangen von Daten, die aus dem pInParams-Parameter kopiert wurden.

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_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 aktualisiert werden.
ERROR_BAD_ARGUMENTS	Mindestens einer der Eingabeparameter war ungültig.

Hinweise

Wenn ein im Parameterblock angegebener Wert bereits in der Clusterdatenbank vorhanden ist, wird der Wert nicht geschrieben. Informationen zum Schreiben aller Werte finden Sie unter ResUtilSetPropertyParameterBlockEx.

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

ResUtilSetPropertyParameterBlock 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

Freigeben über