WSMAN_PLUGIN_STARTUP 콜백 함수(wsman.h)

플러그 인에 대한 시작 콜백을 정의합니다. 여러 애플리케이션을 동일한 프로세스에서 호스트할 수 있으므로 이 메서드는 여러 번 호출할 수 있지만 각 애플리케이션 초기화에 대해 한 번만 호출할 수 있습니다. 플러그 인은 동일한 프로세스 내에서 두 번 이상 초기화할 수 있지만 각 applicationIdentification 값에 대해 한 번만 초기화할 수 있습니다. 이 메서드에서 반환되는 컨텍스트는 애플리케이션에 따라 다릅니다. 반환된 컨텍스트는 애플리케이션과 관련된 모든 향후 플러그 인 호출에 전달됩니다. 모든 WinRM(Windows 원격 관리) 플러그 인은 이 콜백 함수를 구현해야 합니다.

이 메서드의 DLL 진입점 이름은 WSManPluginStartup이어야 합니다.

구문

WSMAN_PLUGIN_STARTUP WsmanPluginStartup;

DWORD WsmanPluginStartup(
  DWORD flags,
  PCWSTR applicationIdentification,
  PCWSTR extraInfo,
  PVOID *pluginContext
)
{...}

매개 변수

flags

다음에 사용하도록 예약됩니다. 0이어야 합니다.

applicationIdentification

호스트된 애플리케이션에 대한 고유 식별자입니다. 기본 WinRM 서비스의 경우 기본값은 wsman입니다. IIS(인터넷 정보 서비스) 호스트의 경우 이 식별자는 해당 호스트의 애플리케이션 엔드포인트와 관련이 있습니다. 예를 들어 wsman/MyCompany/MyApplication입니다.

extraInfo

플러그 인이 등록되었을 때 정보가 저장된 경우 구성 정보를 포함하는 문자열입니다. WinRM 구성을 사용하여 플러그 인을 등록하면 플러그 인은 초기화 중에 유용한 추가 구성 매개 변수를 선택적 노드에 추가할 수 있습니다. 이 정보는 플러그 인이 다른 IIS 호스팅 시나리오에서 사용되고 초기화 중에 약간 다른 런타임 의미 체계가 필요한 경우에 특히 유용할 수 있습니다. 이 문자열은 구성의 XML 복사본입니다(있는 경우). 그렇지 않으면 이 매개 변수가 NULL로 설정됩니다.

pluginContext

특정 애플리케이션 초기화에 대한 컨텍스트입니다. 이 컨텍스트는 이 applicationIdentifier와 연결된 다른 모든 WinRM 플러그 인 호출로 전달됩니다.

반환 값

메서드는 성공하면 NO_ERROR 반환합니다. 그렇지 않으면 오류 코드를 반환합니다. 이 메서드가 오류를 반환하는 경우 WSManPluginShutdown 진입점이 호출되지 않습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	wsman.h
재배포 가능 파일	WINDOWS Server 2008 SP2, WINDOWS Vista SP1 및 Windows Vista sp2의 Windows Management Framework