QueryActCtxSettingsW 함수(winbase.h)

QueryActCtxSettingsW 함수는 활성화 컨텍스트와 쿼리할 특성의 네임스페이스 및 이름을 지정합니다.

구문

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
);

매개 변수

[in, optional] dwFlags

이 값은 0이어야 합니다.

[in, optional] hActCtx

쿼리 중인 활성화 컨텍스트에 대한 핸들입니다.

[in, optional] settingsNameSpace

"; 값을http://schemas.microsoft.com/SMI/2005/WindowsSettings" 포함하는 문자열에 대한 포인터입니다. 또는 NULL입니다. 이러한 값은 동일합니다.

Windows 8 및 Windows Server 2012: "; 값을http://schemas.microsoft.com/SMI/2011/WindowsSettings" 포함하는 문자열에 대한 포인터입니다. 는 유효한 매개 변수이기도 합니다. NULL은 여전히 이전 값과 동일합니다.

[in] settingName

쿼리할 특성의 이름입니다.

[out] pvBuffer

쿼리 결과를 수신하는 버퍼에 대한 포인터입니다.

[in] dwBuffer

쿼리 결과를 수신하는 문자의 버퍼 크기입니다.

[out, optional] pdwWrittenOrRequired

pvBuffer에서 지정하거나 쿼리 결과를 보유하는 데 필요한 버퍼에 기록된 문자 수인 값에 대한 포인터입니다.

반환 값

함수가 성공하면 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

이 함수는 GetLastError를 호출하여 검색할 수 있는 오류를 설정합니다. 예제는 Last-Error 코드 검색을 참조하세요. 오류 코드의 전체 목록은 시스템 오류 코드를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winbase.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll