WSANAMESPACE_INFOEXW 구조체(winsock2.h)

아티클
08/27/2023

WSANAMESPACE_INFOEX 구조에는 네임스페이스 공급자에 대한 모든 등록 정보가 포함됩니다.

구문

typedef struct _WSANAMESPACE_INFOEXW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
  BLOB   ProviderSpecific;
} WSANAMESPACE_INFOEXW, *PWSANAMESPACE_INFOEXW, *LPWSANAMESPACE_INFOEXW;

멤버

NSProviderId

형식: GUID

이 네임스페이스 공급자에 대한 고유한 GUID입니다.

dwNameSpace

형식:DWORD

이 공급자가 지원하는 네임스페이스입니다.

dwNameSpace 멤버에 대한 가능한 값은 Winsock2.h 포함 파일에 나열됩니다. 여러 네임스페이스 공급자가 Windows Vista 이상에 포함되어 있습니다. 다른 네임스페이스 공급자를 설치할 수 있으므로 다음과 같은 가능한 값은 일반적으로 사용할 수 있는 값입니다. 다른 많은 값이 가능합니다.

값	의미
NS_BTH	Bluetooth 네임스페이스입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.
NS_DNS	DNS(도메인 이름 시스템) 네임스페이스입니다.
NS_EMAIL	전자 메일 네임스페이스입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.
NS_NLA	NLA(네트워크 위치 인식) 네임스페이스입니다. 이 네임스페이스 식별자는 Windows XP 이상에서 지원됩니다.
NS_NTDS	Windows NT 디렉터리 서비스(NTDS) 네임스페이스입니다.
NS_PNRPNAME	특정 피어 이름에 대한 피어 투 피어 이름 공간입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.
NS_PNRPCLOUD	피어 이름 컬렉션의 피어 투 피어 이름 공간입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.

fActive

형식: BOOL

TRUE이면 이 네임스페이스 공급자가 활성 상태임을 나타냅니다. FALSE이면 쿼리가 이 네임스페이스 공급자를 구체적으로 참조하는 경우에도 네임스페이스 공급자가 비활성 상태이며 쿼리에 액세스할 수 없습니다.

dwVersion

형식:DWORD

네임스페이스 공급자의 버전 번호입니다.

lpszIdentifier

형식: LPTSTR

네임스페이스 공급자를 식별하는 표시 문자열입니다.

ProviderSpecific

형식: BLOB

네임스페이스 항목과 연결된 공급자별 데이터 Blob입니다.

설명

WSANAMESPACE_INFOEX 구조체는 WSAEnumNameSpaceProvidersEx 및 WSCEnumNameSpaceProvidersEx32 함수에서 사용 가능한 네임스페이스 공급자에 대한 정보를 반환하는 데 사용되는 향상된 버전의 WSANAMESPACE_INFO 구조체입니다. WSANAMESPACE_INFOEX 구조에는 lpProviderInfo 매개 변수에 전달된 네임스페이스 항목과 연결된 공급자별 데이터 Blob이 WSCInstallNameSpaceEx 및 WSCInstallNameSpaceEx32 함수에 포함됩니다.

현재 WSANAMESPACE_INFOEX 구조체의 ProviderSpecific 멤버에서 정보를 사용하는 Windows에 포함된 유일한 네임스페이스는 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자뿐입니다. NS_EMAIL 네임스페이스 공급자에 대한 ProviderSpecific 멤버의 형식은 NAPI_PROVIDER_INSTALLATION_BLOB 구조입니다.

UNICODE 또는 _UNICODE 정의되면 WSANAMESPACE_INFOEXWSANAMESPACE_INFOEXW 정의되고, 이 구조체의 유니코드 버전과 lpszIdentifier 문자열 멤버가 LPWSTR 데이터 형식에 정의됩니다.

UNICODE 또는 _UNICODE 정의되지 않은 경우 WSANAMESPACE_INFOEXWSANAMESPACE_INFOEXA 정의되고 이 구조체의 ANSI 버전과 lpszIdentifier 문자열 멤버가 LPSTR 데이터 형식에 정의됩니다.

WSCEnumNameSpaceProvidersEx32 함수는 유니코드 전용 함수이며 WSANAMESPACE_INFOEXW 구조를 반환합니다.

참고

winsock2.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 WSANAMESPACE_INFOEX 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	winsock2.h