ResUtilGetPropertiesToParameterBlock-Funktion (resapi.h)
Ruft Eigenschaften ab, die von einer Eigenschaftentabelle aus der Clusterdatenbank angegeben werden, und gibt sie in einem Parameterblock zurück.
Syntax
DWORD ResUtilGetPropertiesToParameterBlock(
[in] HKEY hkeyClusterKey,
[in] const PRESUTIL_PROPERTY_ITEM pPropertyTable,
[out] LPBYTE pOutParams,
[in] BOOL bCheckForRequiredProperties,
[out, optional] LPWSTR *pszNameOfPropInError
);
Parameter
[in] hkeyClusterKey
Zeiger auf den Clusterdatenbankschlüssel, der den Speicherort der abzurufenden Eigenschaften identifiziert.
[in] pPropertyTable
Zeiger auf ein Array von RESUTIL_PROPERTY_ITEM Strukturen, das die zu verarbeitenden Eigenschaften beschreibt.
[out] pOutParams
Zeiger auf den zu füllenden Ausgabeparameterblock.
[in] bCheckForRequiredProperties
Gibt an, ob ein Fehler generiert werden soll, wenn erforderliche Eigenschaften fehlen.
[out, optional] pszNameOfPropInError
Adresse des Zeichenfolgenzeigers, in dem der Name des Fehlers zurückgegeben werden soll, der von einer fehlenden erforderlichen Eigenschaft generiert wird. Die ppszNameOfPropInError-Eigenschaft ist optional.
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 finden Sie mögliche Fehlercodes.
| Rückgabecode | Beschreibung |
|---|---|
|
Mindestens einer der Eingabeparameter war ungültig. |
|
Fehler beim Zuweisen von Arbeitsspeicher. |
Hinweise
Mit der Hilfsprogrammfunktion ResUtilGetPropertiesToParameterBlock kann die Eigenschaftentabelle, auf die pPropertyTable verweist, Standardwerte enthalten.
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 |