WsAlloc 함수(webservices.h)

지정된 힙에서 메모리 세그먼트를 할당 합니다.

구문

HRESULT WsAlloc(
  [in]           WS_HEAP  *heap,
  [in]           SIZE_T   size,
                 void     **ptr,
  [in, optional] WS_ERROR *error
);

매개 변수

[in] heap

메모리를 할당할 힙을 나타내는 WS_HEAP 구조체에 대한 포인터입니다.

[in] size

할당할 바이트 수입니다. 이 값은 0일 수 있습니다.

ptr

성공 시 할당된 메모리의 주소를 받는 포인터입니다. 이 포인터는 힙에서 WsFreeHeap 또는 WsResetHeap이 호출될 때까지 유효합니다.

반환된 포인터는 8 바이트 경계에 맞춰집니다.

0 바이트 할당은 NULL이 아닌 포인터를 반환합니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 수신하는 WS_ERROR 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

반환 코드	설명
WS_E_QUOTA_EXCEEDED	요청된 바이트는 이미 할당된 바이트 외에도 WS_HEAP_PROPERTY_MAX_SIZE 속성에 지정된 힙 크기를 초과합니다.
E_OUTOFMEMORY	메모리가 부족하여 작업을 완료할 수 없습니다.

설명

이 함수에서 반환된 메모리는 0이 초기화되지 않으며 정의되지 않은 값을 포함합니다.

요구 사항

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