WskRegister 함수(wsk.h)

  • 아티클

WskRegister 함수는 애플리케이션의 WSK 클라이언트 NPI(네트워크 프로그래밍 인터페이스)가 지정된 WSK 애플리케이션을 등록합니다.

구문

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

매개 변수

[in] WskClientNpi

WSK 애플리케이션에서 구현한 클라이언트 NPI에 대한 포인터입니다.

[out] WskRegistration

WSK 애플리케이션의 등록 instance 식별하는 메모리 위치에 대한 포인터입니다. 이 메모리 위치는 WskRegister 호출에 의해 초기화되며 다른 WSK 등록 함수에서 사용됩니다. WSK 애플리케이션은 이 메모리 위치의 내용을 직접 변경해서는 안 됩니다.

반환 값

WskRegister 는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
 등록에 성공했습니다.
기타 상태 코드
 등록에 실패했습니다.

설명

WSK 클라이언트 개체는 이 함수를 여러 번 호출할 수 있지만 여러 등록 인스턴스를 만들려면 각 호출에 다른 WskRegistration 매개 변수를 사용해야 합니다.

성공 코드를 반환하는 WskRegister 에 대한 각 호출에 대해 WskRegister 에 전달된 것과 동일한 WskRegistration 매개 변수를 사용하는 정확히 하나의 해당 WskDeregister 호출이 있어야 합니다.

WskRegistration에서 가리키는 메모리 블록은 다른 WSK 등록 함수에 대한 미해결 호출이 있는 한 할당된 상태로 유지되어야 합니다(해제되거나 scope 나가지 않아야 함).

WskRegister 및 WskDeregister 함수를 사용하는 것이 WSK 애플리케이션을 등록 및 등록 취소하는 데 선호되는 방법입니다. 네트워크 모듈 등록 기관은 호환성을 위해 계속 사용할 수 있습니다.

WSK 하위 시스템에 WSK 애플리케이션을 연결하는 방법에 대한 자세한 내용은 Winsock 커널 애플리케이션 등록을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 wsk.h(Wsk.h 포함)
라이브러리 Netio.lib
IRQL PASSIVE_LEVEL

추가 정보

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister