WsCreateHeap 함수(webservices.h)

힙 개체를 만듭니다.

구문

HRESULT WsCreateHeap(
  [in]           SIZE_T                 maxSize,
  [in]           SIZE_T                 trimSize,
  [in, optional] const WS_HEAP_PROPERTY *properties,
  [in]           ULONG                  propertyCount,
                 WS_HEAP                **heap,
  [in, optional] WS_ERROR               *error
);

매개 변수

[in] maxSize

힙에서 할당할 수 있는 총 바이트 수입니다. 총 바이트 수는 힙을 만들거나 다시 설정한 이후 WsAlloc 함수에 대한 모든 호출에서 전달된 크기의 합계로 정의됩니다.

[in] trimSize

WsResetHeap 함수를 호출하여 힙이 다시 설정된 후 힙이 유지하는 최대 메모리 바이트 수입니다. 힙 오버헤드로 인한 근사값입니다.

참고trimSize 값이 maxSize 값보다 크면 힙 크기가 원하는 크기로 조정되지 않습니다.

 

[in, optional] properties

향후 사용을 위해 예약됨; 을 NULL로 설정합니다.

[in] propertyCount

향후 사용을 위해 예약됨; 를 0으로 설정합니다.

heap

성공하면 새 힙 개체를 나타내는 WS_HEAP 구조체의 주소를 받는 포인터입니다.

[in, optional] error

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

반환 값

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

설명

Windows Web Services API의 힙은 메시지에 사용되는 메모리 할당입니다. 힙을 사용하여 메시지 수명과 별도로 메시지 데이터를 저장할 수도 있습니다. 일부 API 함수는 모든 데이터 읽기의 수명 동안 명시적 힙 제어를 허용합니다.

새 힙을 만들면 메모리가 할당되지 않습니다( WS_HEAP 구조 자체에 필요한 메모리 제외). maxSize 및 trimSize 매개 변수는 WsAlloc 및 WsResetHeap 작업만을 할당량으로 사용합니다.

요구 사항

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