POPEN_ROUTINE 콜백 함수(resapi.h)

리소스를 엽니다. POPEN_ROUTINE 형식은 이 함수에 대한 포인터를 정의합니다.

구문

POPEN_ROUTINE PopenRoutine;

RESID PopenRoutine(
  [in] LPCWSTR ResourceName,
  [in] HKEY ResourceKey,
  [in] RESOURCE_HANDLE ResourceHandle
)
{...}

매개 변수

[in] ResourceName

열 리소스의 이름입니다.

[in] ResourceKey

ResourceName으로 표시되는 리소스를 포함하는 클러스터의 클러스터 데이터베이스 키입니다.

[in] ResourceHandle

시작 진입점 함수의 SetResourceStatus 콜백 함수에 전달할 핸들입니다.

반환 값

작업이 성공하면 Open 은 RESID(리소스 식별자)를 반환합니다.

작업이 성공하지 못한 경우 Open 은 NULL을 반환합니다. SetLastError를 호출하여 오류가 발생했음을 지정합니다.

설명

Open 진입점 함수는 ResourceName 매개 변수로 식별된 이름의 리소스를 열고 해당 리소스 식별자를 반환합니다. 리소스 식별자는 나중에 다른 리소스 API 진입점에 대한 호출에서 리소스를 식별하는 데 사용할 수 있습니다.

ResourceHandle 매개 변수로 표시되는 핸들을 닫거나 LogEvent 콜백 함수 또는 SetResourceStatus 콜백 함수를 통해 리소스 모니터에 전달하는 것 이외의 용도로 사용하지 마세요.

Open 진입점 함수의 효과적인 구현 전략은 Open 구현을 참조하세요.

예제

리소스 DLL 예제를 참조하세요.

요구 사항

추가 정보

LogEvent

리소스 DLL Entry-Point 함수

SetResourceStatus