IHostSecurityContext::Capture 메서드

IHostSecurityManager::GetSecurityContext 호출에서 반환된 IHostSecurityContext 인스턴스의 복제본을 가져옵니다.

구문

HRESULT Capture (  
    [out] IHostSecurityContext** ppClonedContext  
);

ppClonedContext
[out] 캡처할 IHostSecurityContext 개체의 복제본 주소에 대한 포인터입니다.

HRESULT	설명
S_OK	`Capture`가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태에 있습니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED	차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.

Capture에서 반환된 인터페이스 포인터는 캡처된 컨텍스트의 복제본입니다. 이 정보가 비동기 코드 포인트 간에 이동하면 해당 수명은 호출된 포인터의 수명과 분리됩니다. 따라서 원래 포인터를 해제할 수 있습니다.

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능