SHRegGetValueFromHKCUHKLM-Funktion (shlwapi.h)

[Diese Funktion wird nicht mehr unterstützt.]

Ruft angegebene Informationen aus der Registrierung ab. Diese Funktion überprüft HKEY_CURRENT_USER auf die angeforderten Informationen im angegebenen Unterschlüssel. Wenn die Informationen nicht unter der HKEY_CURRENT_USER Unterstruktur vorhanden sind, überprüft die Funktion die HKEY_LOCAL_MACHINE Unterstruktur auf die gleichen Informationen.

Syntax

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Parameter

[in] pwszKey

Typ: PCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Termin, die den Pfad zum Registrierungsschlüssel angibt.

[in] pwszValue

Typ: PCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Schlüsselwert angibt. Dieser Wert kann NULL sein. In diesem Fall werden Daten aus dem Standardwert abgerufen.

[in] srrfFlags

Typ: SRRF

Die SRRF-Flagkonstanten. Wenn mehrere Flags verwendet werden, können sie mit einem bitweisen OR kombiniert werden. Diese Flags werden verwendet, um den Typ der zurückgegebenen Daten einzuschränken. Dieser Wert darf nicht 0 sein.

[out] pdwType

Typ: DWORD*

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf ein DWORD , das einen Code empfängt, der den Typ der im angegebenen Wert gespeicherten Daten angibt. Dies kann auf NULL festgelegt werden, wenn keine Typinformationen gewünscht werden. Wenn dieser Wert nicht NULL ist und das flag SRRF_NOEXPAND nicht festgelegt wurde, werden Datentypen von REG_EXPAND_SZ als REG_SZ zurückgegeben, da sie in dieser Methode automatisch erweitert werden.

[in] pvData

Typ: LPCVOID

Ein Zeiger auf einen Puffer, der die Daten des Werts enthält. Dieser Parameter kann NULL sein, wenn die Daten nicht benötigt werden. Dieser Wert muss die Größe des pvData-Puffers beim Eintrag enthalten. Wenn pvDataNULL ist (oder wenn pvData nicht NULL, sondern zu klein ist, um die Registrierungsdaten zu speichern), enthält es beim Beenden die Größe, die zum Speichern der Registrierungsdaten erforderlich ist.

[in, out] pcbData

Typ: DWORD*

Wenn diese Funktion zurückgibt, enthält einen Zeiger auf die Größe der Daten in Byte.

Rückgabewert

Typ: LONG

Bei erfolgreicher Ausführung gibt diese Funktion ERROR_SUCCESS und alle angeforderten Parameter zurück. Gibt ERROR_MORE_DATA zurück, wenn die Funktion aufgrund des unzureichenden Speicherplatzes in einem bereitgestellten pvData-Wert ungleich NULL fehlschlägt. In diesem Fall dürfen nur pdwType und pcbData gültige Daten enthalten, pvData ist undefiniert. Andernfalls wird ein fehlercode ungleich null zurückgegeben, der in "Winerror.h" definiert ist. Sie können die FormatMessage-Funktion mit dem flag FORMAT_MESSAGE_FROM_SYSTEM verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
DLL	Shlwapi.dll