JET_PFNREALLOC 콜백 함수

아티클
06/13/2023

적용 대상: Windows | Windows Server

JET_PFNREALLOC 콜백 함수

JET_PFNREALLOC 함수는 JetEnumerateColumns에서 출력 버퍼에 대한 메모리를 할당하는 데 사용하는 재할당 호환 콜백입니다.

    void * JET_API JET_PFNREALLOC(
      [in]                 void* pvContext,
      [in]                 void* pv,
      [in]                 unsigned long cb
    );

매개 변수

pvContext

JetEnumerateColumns에 지정된 컨텍스트 포인터입니다. 이 컨텍스트 포인터를 사용하여 JetEnumerateColumns 호출자에서 이 콜백의 구현으로 상태를 전달할 수 있습니다.

태양광 발전

NULL이 아닌 경우 이 콜백에서 이전에 할당한 메모리 블록에 대한 포인터를 지정합니다. NULL이면 요청된 크기의 새 메모리 블록이 할당됩니다.

메모리 블록의 새 크기(바이트)입니다. 이 매개 변수가 0이고 메모리 블록이 지정되면 해당 메모리 블록이 해제됩니다.

반환 값

시스템은 이 함수에 대한 호출의 결과로 성공 또는 실패 코드를 생성할 수 있습니다. 이러한 코드를 HRESULT로 반환하는 방법에 대한 자세한 내용은 확장 가능한 스토리지 엔진 오류를 참조하세요.

반환 코드	설명
Success	이전에 할당된 메모리 블록을 지정하고 새 크기 0을 지정한 경우 해당 블록이 해제되고 NULL이 반환됩니다. 이전에 할당된 메모리 블록을 지정하고 0이 아닌 새 크기를 지정한 경우 다시 할당된 메모리 블록이 반환됩니다. 지정된 메모리 블록이 없으면 지정된 크기의 새로 할당된 메모리 블록이 반환됩니다.
실패	NULL이 반환됩니다. 이전에 할당된 메모리 블록이 제공된 경우 해당 블록은 할당된 상태로 유지됩니다.

반환 코드

설명

Success

이전에 할당된 메모리 블록을 지정하고 새 크기 0을 지정한 경우 해당 블록이 해제되고 NULL이 반환됩니다. 이전에 할당된 메모리 블록을 지정하고 0이 아닌 새 크기를 지정한 경우 다시 할당된 메모리 블록이 반환됩니다. 지정된 메모리 블록이 없으면 지정된 크기의 새로 할당된 메모리 블록이 반환됩니다.

실패

NULL이 반환됩니다. 이전에 할당된 메모리 블록이 제공된 경우 해당 블록은 할당된 상태로 유지됩니다.

요구 사항

요구 사항	값
클라이언트	Windows Vista, Windows XP 또는 Windows 2000 Professional이 필요합니다.
서버	Windows Server 2008, Windows Server 2003 또는 Windows 2000 Server가 필요합니다.
머리글	Esent.h에서 선언되었습니다.

참고 항목

JetEnumerateColumns

Share via

JET_PFNREALLOC 콜백 함수