ResUtilGetProperty-Funktion (resapi.h)

Gibt eine angegebene Eigenschaft aus der Clusterdatenbank zurück. Der PRESUTIL_GET_PROPERTY-Typs definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ResUtilGetProperty(
  [in]      HKEY                         hkeyClusterKey,
  [in]      const PRESUTIL_PROPERTY_ITEM pPropertyTableItem,
  [out]     PVOID                        *pOutPropertyItem,
  [in, out] LPDWORD                      pcbOutPropertyItemSize
);

Parameter

[in] hkeyClusterKey

Zeiger auf den Clusterdatenbankschlüssel, der den Speicherort der abzurufenden Eigenschaft identifiziert.

[in] pPropertyTableItem

Zeiger auf eine RESUTIL_PROPERTY_ITEM Struktur, die die abzurufende Eigenschaft beschreibt.

[out] pOutPropertyItem

Zeiger auf einen Ausgabepuffer, in dem die angeforderte Eigenschaft zurückgegeben werden soll. Es wird davon ausgegangen, dass der Puffer Teil einer Eigenschaftsliste ist.

[in, out] pcbOutPropertyItemSize

Zeiger auf die Größe des Ausgabepuffers in Bytes, auf die pOutPropertyItem verweist.

Rückgabewert

Wenn die Vorgänge erfolgreich sind, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden ist ein möglicher Fehlercode aufgeführt.

Rückgabecode	Beschreibung
ERROR_BAD_ARGUMENTS	Mindestens ein Eingabeparameter war ungültig.

Anforderungen

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