ResUtilSetPropertyTableEx-Funktion (resapi.h)

Artikel
03/01/2024

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

Syntax

DWORD ResUtilSetPropertyTableEx(
  [in]            HKEY                         hkeyClusterKey,
  [in]            const PRESUTIL_PROPERTY_ITEM pPropertyTable,
                  PVOID                        Reserved,
  [in]            BOOL                         bAllowUnknownProperties,
  [in]            const PVOID                  pInPropertyList,
  [in]            DWORD                        cbInPropertyListSize,
  [in]            BOOL                         bForceWrite,
  [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.

[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 , der zurückgegebene Daten enthält. Wenn dies der Zeiger ist, werden nur Parameter, die sich von denen im Eingabepuffer unterscheiden, in den Parameterblock geschrieben.

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

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

ResUtilSetPropertyTableEx kann von jeder anderen Ressourcen-DLL-Einstiegspunktfunktion oder von 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

ResUtilSetPropertyTable

Freigeben über