ResUtilFindMultiSzProperty 함수(resapi.h)

속성 목록에서 여러 문자열 속성을 찾습니다. PRESUTIL_FIND_MULTI_SZ_PROPERTY 형식은 이 함수에 대한 포인터를 정의합니다.

구문

DWORD ResUtilFindMultiSzProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPWSTR      *pszPropertyValue,
  [out] LPDWORD     pcbPropertyValueSize
);

매개 변수

[in] pPropertyList

값을 찾을 속성 목록에 대한 포인터입니다.

[in] cbPropertyListSize

pPropertyList에 포함된 데이터의 크기(바이트)입니다.

[in] pszPropertyName

찾을 값의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

[out] pszPropertyValue

속성 값의 복사본을 포함하는 버퍼(함수에 의해 할당됨)에 대한 WCHAR 포인터에 대한 포인터입니다. 할당된 메모리를 해제하려면 LocalFree (*pbPropertyValue)를 호출해야 합니다. 값이 필요하지 않은 경우 이 매개 변수에 대해 NULL 을 전달합니다.

[out] pcbPropertyValueSize

반환된 값의 크기(바이트)에 대한 포인터입니다. 크기가 필요하지 않은 경우 이 매개 변수에 대해 NULL 을 전달합니다.

반환 값

작업이 성공하면 함수는 ERROR_SUCCESS 반환합니다.

작업이 실패하면 함수는 시스템 오류 코드를 반환합니다. 가능한 오류 코드는 다음과 같습니다.

반환 코드	설명
ERROR_INVALID_DATA	속성 목록의 형식이 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY	함수는 속성 값을 반환할 버퍼를 할당할 수 없습니다.
ERROR_FILE_NOT_FOUND	지정된 속성을 속성 목록에 찾을 수 없습니다.

설명

ResUtilFindMultiSzProperty가 성공하면 *pbPropertyValue는 pPropertyList에 저장된 데이터의 복사본을 가리킵니다. 메모리 누수 방지를 위해 *pbPropertyValue에서 LocalFree를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
대상 플랫폼	Windows
헤더	resapi.h
라이브러리	ResUtils.lib
DLL	ResUtils.dll