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 unter der HKEY_CURRENT_USER-Unterstruktur nicht 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
);

Die Parameter

[in] pwszKey

Typ: PCWSTR-

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

[in] pwszValue

Typ: PCWSTR-

Ein Zeiger auf eine mit Null beendete Unicode-Zeichenfolge, 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 Kennzeichnungen 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ückgegeben wird, enthält sie einen Zeiger auf ein DWORD , das einen Code empfängt, der den Datentyp angibt, der im angegebenen Wert gespeichert ist. 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 für den Eintrag enthalten. Wenn pvDataNULL ist (oder pvData nicht NULL ist, aber zu klein von einem Puffer, um die Registrierungsdaten zu speichern), enthält es beim Beenden die erforderliche Größe, um die Registrierungsdaten zu speichern.

[in, out] pcbData

Typ: DWORD*

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

Rückgabewert

Typ: LONG

Wenn die Funktion erfolgreich verläuft, werden ERROR_SUCCESS und alle angeforderten Parameter zurückgegeben. Gibt ERROR_MORE_DATA zurück, wenn die Funktion aufgrund unzureichenden Speicherplatzes in einer bereitgestellten nicht NULL PvData fehlschlägt. In diesem Fall dürfen nur pdwType und pcbData gültige Daten enthalten, pvData wird nicht definiert. Andernfalls wird ein nichtzero-Fehlercode zurückgegeben, der in Winerror.h definiert ist. Sie können die FormatMessage-Funktion mit dem FORMAT_MESSAGE_FROM_SYSTEM Flag verwenden, um eine generische Beschreibung des Fehlers abzurufen.

Anforderungen