ResUtilSetPropertyParameterBlockEx-Funktion (resapi.h)

Artikel
03/01/2024

Legt Eigenschaften in der Clusterdatenbank aus einem Parameterblock fest.

Syntax

DWORD ResUtilSetPropertyParameterBlockEx(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [in]            PVOID                        Reserved,
  [in]            const LPBYTE                 pInParams,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [in]            BOOL                         bForceWrite,
  [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 in der Eigenschaftentabelle beschriebenen Eigenschaften enthält, 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 in Bytes des Eingabepuffers, auf den pInPropertyList verweist.

[in] bForceWrite

Erzwingt, dass die Eigenschaftswerte in die Clusterdatenbank geschrieben werden, auch wenn die neuen Werte mit den vorhandenen Werten identisch sind.

[out, optional] pOutParams

Zeiger auf einen Parameterblock, um daten zu empfangen, 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 sind mögliche Fehlercodes aufgeführt.

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 ein Eingabeparameter war ungültig.

Hinweise

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

ResUtilSetPropertyParameterBlockEx kann sicher von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder aus einem Workerthread 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

ResUtilSetPropertyParameterBlock

Freigeben über