WSANAMESPACE_INFOEXW 구조체(winsock2.h)
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 이상에 포함되어 있습니다. 다른 네임스페이스 공급자를 설치할 수 있으므로 다음과 같은 가능한 값은 일반적으로 사용할 수 있는 값입니다. 다른 많은 값이 가능합니다.
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 |