UtilLoadStringWithAlloc 함수

UtilLoadStringWithAlloc 함수는 리소스 테이블에서 문자열을 할당하고 로드합니다.

구문

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

uID [in]

형식: UINT

로드할 문자열의 식별자입니다.

ppwzBuffer [out]

형식: LPWSTR*

새로 할당된 문자열을 배치할 위치입니다. 더 이상 필요하지 않은 경우 CoTaskMemFree 를 사용하여 문자열을 해제해야 합니다.

cchBufferMax [in]

형식: UINT

리소스 테이블에서 로드할 최대 문자 수입니다. 리소스 문자열이 지정된 문자 수보다 길면 잘리고 null로 종료됩니다.

참고

이 매개 변수는 0으로 설정되지 않을 수 있습니다.

형식: HRESULT

가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.

반환 코드	Description
S_OK	작업에 성공했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 올바르게 제공되지 않았습니다.