NPI_REGISTRATION_INSTANCE 구조체(netioddk.h)

NPI_REGISTRATION_INSTANCE 구조는 NMR을 사용하여 네트워크 모듈 등록과 관련된 데이터를 정의합니다.

구문

typedef struct _NPI_REGISTRATION_INSTANCE {
  USHORT        Version;
  USHORT        Size;
  PNPIID        NpiId;
  PNPI_MODULEID ModuleId;
  ULONG         Number;
  const VOID    *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;

멤버

Version

네트워크 모듈이 등록되는 NMR의 버전입니다. 네트워크 모듈은 이 멤버를 0으로 설정해야 합니다.

Size

NPI_REGISTRATION_INSTANCE 구조체의 크기(바이트)입니다.

NpiId

네트워크 모듈이 클라이언트 또는 공급자로 등록하는 특정 NPI에 대한 NPI 식별자에 대한 포인터입니다. NPIID 데이터 형식은 다음과 같이 정의됩니다.

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

네트워크 모듈을 고유하게 식별하는 NPI_MODULEID 구조체에 대한 포인터입니다.

Number

네트워크 모듈이 클라이언트 또는 공급자로 등록하는 NPI 의 구현 번호입니다. 네트워크 모듈은 각 NPI 구현의 클라이언트 또는 공급자로 등록하여 동일한 NPI의 여러 구현을 지원할 수 있습니다. NPI 구현이 하나만 있는 경우 이 멤버는 0으로 설정됩니다.

NpiSpecificCharacteristics

네트워크 모듈에 고유한 특성을 지정하는 구조체에 대한 포인터입니다. 구조체의 내용은 NPI에 따라 다릅니다. 네트워크 모듈은 클라이언트 특성 구조를 정의하지 않는 NPI의 클라이언트로 등록하거나 공급자 특성 구조를 정의하지 않는 NPI 공급자로 등록하는 경우 이 멤버를 NULL 로 설정해야 합니다.

설명

NPI_REGISTRATION_INSTANCE 구조체는 NPI_CLIENT_CHARACTERISTICS 및 의 멤버입니다. 구조체를 NPI_PROVIDER_CHARACTERISTICS . 이러한 구조는 NMR에 네트워크 모듈을 등록하는 데 사용됩니다.

NMR은 클라이언트 모듈의 ClientAttachProvider 콜백 함수를 호출할 때 클라이언트 모듈이 직접 연결할 수 있는 공급자 모듈의 NPI_REGISTRATION_INSTANCE 구조에 대한 포인터를 전달합니다. 마찬가지로 NMR이 공급자 모듈의 ProviderAttachClient 콜백 함수를 호출하면 공급자 모듈이 직접 연결할 수 있는 클라이언트 모듈의 NPI_REGISTRATION_INSTANCE 구조에 대한 포인터를 전달합니다.

네트워크 모듈은 NpiId 멤버가 가리키는 NPIID의 메모리, ModuleId 멤버가 가리키는 NPI_MODULEID 구조체에 대한 메모리 및 NpiSpecificCharacteristics 멤버가 가리키는 NPI 관련 특성 구조에 대한 메모리가 NMR에 등록된 한 메모리에서 유효하고 상주하도록 해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다.
머리글	netioddk.h(Wsk.h 포함)

추가 정보

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient