WindowsDeleteStringBuffer 함수(winstring.h)

HSTRING으로 승격되지 않은 경우 미리 할당된 문자열 버퍼를 삭제합니다.

구문

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

매개 변수

bufferHandle

형식: [in] HSTRING_BUFFER

삭제할 버퍼입니다. WindowsPreallocateStringBuffer 함수에 대한 호출로 bufferHandle이 할당되지 않은 경우 WindowsDeleteStringBuffer 함수는 예외를 발생합니다.

반환 값

형식: HRESULT

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	버퍼가 성공적으로 삭제되었습니다.
E_POINTER	bufferHandle 은 NULL입니다.

설명

WindowsDeleteStringBuffer 함수를 사용하여 WindowsPreallocateStringBuffer 함수에서 만들었지만 WindowsPromoteStringBuffer 함수에 의해 HSTRING으로 승격되지 않은 문자열 버퍼를 삭제합니다.

참고 동일한 버퍼 핸들 을 사용하여 WindowsDeleteStringBuffer 를 호출한 후 WindowsPromoteStringBuffer 를 호출하는 것은 정의되지 않습니다.

 

예제

다음 코드 예제에서는 WindowsDeleteStringBuffer 함수를 사용하는 방법을 보여 줍니다.

int main()
{
    HSTRING_BUFFER hStringBuffer = NULL;
    PWSTR strBuffer = NULL;
    HRESULT hr = WindowsPreallocateStringBuffer(10, &strBuffer, &hStringBuffer);

    // You hit a case in which you need to discard the buffer.

    WindowsStringDeleteBuffer(hStringBuffer);
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2012 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	winstring.h
라이브러리	RuntimeObject.lib
DLL	ComBase.dll

추가 정보

HSTRING

HSTRING_BUFFER

WindowsPreallocateStringBuffer

WindowsPromoteStringBuffer