WSANAMESPACE_INFOW 구조체(winsock2.h)

아티클
11/20/2024

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

통사론

typedef struct _WSANAMESPACE_INFOW {
  GUID   NSProviderId;
  DWORD  dwNameSpace;
  BOOL   fActive;
  DWORD  dwVersion;
  LPWSTR lpszIdentifier;
} WSANAMESPACE_INFOW, *PWSANAMESPACE_INFOW, *LPWSANAMESPACE_INFOW;

회원

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 NTDS(NTDS) 네임스페이스입니다.
NS_PNRPNAME	특정 피어 이름의 피어 투 피어 이름 공간입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.
NS_PNRPCLOUD	피어 이름 컬렉션의 피어 투 피어 이름 공간입니다. 이 네임스페이스 식별자는 Windows Vista 이상에서 지원됩니다.

fActive

형식: BOOL

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

dwVersion

형식: DWORD

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

lpszIdentifier

형식: LPTSTR

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

발언

WSANAMESPACE_INFO 구조체는 WSAEnumNameSpaceProviders 및 WSCEnumNameSpaceProviders32 함수에서 사용 가능한 네임스페이스 공급자에 대한 정보를 반환하는 데 사용됩니다. WSANAMESPACE_INFO 구조에는 네임스페이스 공급자가 설치되었을 때 WSCInstallNameSpace 전달되고 WSCInstallNameSpace32 함수를 네임스페이스 항목에 대한 공급자별 정보가 포함됩니다.

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

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

Windows Vista 이상에서는 WSANAMESPACE_INFO 구조의 향상된 버전인 WSANAMESPACE_INFOEX WSAEnumNameSpaceProvidersEx 및 WSCEnumNameSpaceProvidersEx32 함수를 호출하여 반환됩니다.

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
헤더	winsock2.h