QueryActCtxSettingsW-Funktion (winbase.h)

Artikel
08/27/2023

Die QueryActCtxSettingsW-Funktion gibt den Aktivierungskontext sowie den Namespace und namen des attributs an, das abgefragt werden soll.

Syntax

BOOL QueryActCtxSettingsW(
  [in, optional]  DWORD  dwFlags,
  [in, optional]  HANDLE hActCtx,
  [in, optional]  PCWSTR settingsNameSpace,
  [in]            PCWSTR settingName,
  [out]           PWSTR  pvBuffer,
  [in]            SIZE_T dwBuffer,
  [out, optional] SIZE_T *pdwWrittenOrRequired
);

Parameter

[in, optional] dwFlags

Der Wert muss 0 (null) sein.

[in, optional] hActCtx

Ein Handle für den Aktivierungskontext, der abgefragt wird.

[in, optional] settingsNameSpace

Ein Zeiger auf eine Zeichenfolge, die den Wert "http://schemas.microsoft.com/SMI/2005/WindowsSettings" oder NULL. Diese Werte sind gleichwertig.

Windows 8 und Windows Server 2012: Ein Zeiger auf eine Zeichenfolge, die den Wert "http://schemas.microsoft.com/SMI/2011/WindowsSettings" ist auch ein gültiger Parameter. Ein NULL-Wert entspricht weiterhin dem vorherigen Wert.

[in] settingName

Der Name des abzufragten Attributs.

[out] pvBuffer

Ein Zeiger auf den Puffer, der das Abfrageergebnis empfängt.

[in] dwBuffer

Die Größe des Puffers in Zeichen, der das Abfrageergebnis empfängt.

[out, optional] pdwWrittenOrRequired

Ein Zeiger auf einen Wert, der die Anzahl der Zeichen darstellt, die in den von pvBuffer angegebenen Puffer geschrieben werden, oder der zum Speichern des Abfrageergebnisses erforderlich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben.

Diese Funktion legt Fehler fest, die durch Aufrufen von GetLastError abgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Codes. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Share via