NAPI_PROVIDER_INSTALLATION_BLOB 구조체(nsemail.h)
NAPI_PROVIDER_INSTALLATION_BLOB 구조에는 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자를 설치하는 데 필요한 정보가 포함되어 있습니다.
구문
typedef struct napi_provider_installation_blob_tag {
DWORD dwVersion;
DWORD dwProviderType;
DWORD fSupportsWildCard;
ULONG cDomains;
ULONG OffsetFirstDomain;
} NAPI_PROVIDER_INSTALLATION_BLOB;
멤버
dwVersion
형식:DWORD
NS_EMAIL 네임스페이스 공급자의 버전 번호입니다. 이 멤버는 네임스페이스 공급자와 관련이 있습니다.
dwProviderType
형식:DWORD
NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자의 형식입니다. 이 멤버는 Nsemail.h 헤더 파일에 정의된 NAPI_PROVIDER_TYPE 열거형 형식의 값 중 하나일 수 있습니다.
fSupportsWildCard
형식:DWORD
이 NS_EMAIL 네임스페이스 공급자가 와일드카드 이름을 지원하는지 여부를 나타내는 부울 값입니다. 이 멤버가 0이 아닌 경우 NS_EMAIL 공급자는 공급자가 특별히 기본 또는 보조 도메인으로 등록된 도메인에 속하지 않는 이름을 resolve 등록할 수 있다고 주장합니다. 이 멤버가 0이 아닌 경우 도메인에 대한 기본 또는 보조 공급자를 사용할 수 없는 경우 NS_EMAIL 공급자를 호출하여 주소를 resolve 등록할 수 있습니다.
주소(fSupportsWildCard가 0이 아닌 것으로 설정됨)를 resolve 수 있다고 주장하는 공급자가 여러 곳 있을 수 있습니다. 와일드카드 공급자로도 등록된 이 값을 가진 네임스페이스 공급자가 있는 경우 공급자는 Winsock 네임스페이스 카탈로그에 표시되는 순서대로 호출됩니다.
cDomains
형식:DWORD
이 NS_EMAIL 네임스페이스 공급자가 지원하는 도메인을 설명하는 데 사용되는 OffsetFirstDomain 멤버에서 시작하는 NAPI_DOMAIN_DESCRIPTION_BLOB 구조의 수입니다.
OffsetFirstDomain
형식:DWORD
이 NS_EMAIL 네임스페이스 공급자가 지원하는 도메인을 설명하는 데 사용되는 여러 NAPI_DOMAIN_DESCRIPTION_BLOB 구조 중 첫 번째에 대한 오프셋(바이트)입니다. 이 오프셋은 최소 4 바이트 경계에 맞춰야 합니다.
설명
이 구조는 Windows Vista 이상에서 지원됩니다.
NAPI_PROVIDER_INSTALLATION_BLOB 구조에는 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자를 설치하는 데 필요한 정보가 포함되어 있습니다. 로컬 시스템에 NS_EMAIL 네임스페이스 설치에 대한 네임스페이스 공급자가 여러 명 있을 수 있습니다.
NS_EMAIL 네임스페이스에 등록된 각 네임스페이스 공급자는 여러 도메인을 지원할 수 있습니다. 결과적으로 NS_EMAIL 네임스페이스 공급자에 대한 NAPI_PROVIDER_INSTALLATION_BLOB 구조체에 여러 NAPI_DOMAIN_DESCRIPTION_BLOB 구조가 있을 수 있습니다. 지원되는 도메인 목록은 공급자 등록 Blob에서 NAPI_DOMAIN_DESCRIPTION_BLOB 구조 목록으로 지정됩니다. 지원되는 각 도메인 사양에는 해당 도메인에 대해 공급자가 제공하는 권한 수준을 설명하는 NAPI_DOMAIN_DESCRIPTION_BLOB AuthLevel 멤버의 NAPI_PROVIDER_LEVEL 값이 포함되어 있습니다.
네임스페이스 공급자는 도메인에 주소를 resolve 등록하기 위해 다음 순서로 호출됩니다. 도메인의 기본 공급자로 등록된 네임스페이스 공급자를 먼저 호출합니다. 네임스페이스 쿼리에서 신뢰할 수 있는 결과가 요청되는지 여부에 따라 두 가지 경우가 있습니다. 쿼리의 기본값은 신뢰할 수 있는 결과를 요청하는 것입니다.
쿼리에서 신뢰할 수 있는 결과가 요청되면 네임스페이스 공급자가 다음과 같이 호출됩니다. 주 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 첫 번째 보조 공급자가 호출됩니다. 보조 공급자를 사용할 수 없거나 주소를 resolve 또는 등록할 수 없는 경우 Winsock 카탈로그의 다음 보조 공급자가 호출됩니다. 모든 보조 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 첫 번째 와일드카드 공급자가 호출됩니다. 첫 번째 와일드카드 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 다음 와일드카드 공급자가 호출됩니다.
쿼리에서 신뢰할 수 없는 결과가 요청되면 네임스페이스 공급자가 다음과 같이 호출됩니다. 주 공급자, 모든 보조 공급자 및 모든 와일드카드 공급자가 호출되고 모든 쿼리의 결과가 반환됩니다. 주 공급자를 먼저 호출합니다. 보조 공급자는 Winsock 카탈로그의 순서에 따라 다음에 호출됩니다. 와일드카드 공급자는 Winsock 카탈로그의 순서에 따라 다음에 호출됩니다. 반환되는 결과는 쿼리 순서를 기반으로 합니다.
WSCInstallNameSpaceEx 및 WSCInstallNameSpaceEx32 함수는 NAPI_PROVIDER_INSTALLATION_BLOB 구조를 사용하여 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자를 설치하는 데 사용됩니다.
WSAEnumNameSpaceProvidersEx 및 WSCEnumNameSpaceProvidersEx32 함수는 모든 네임스페이스 공급자(NS_EMAIL 네임스페이스 공급자 포함)를 열거하고 공급자가 설치 시 Blob을 등록한 경우 공급자의 NAPI_PROVIDER_INSTALLATION_BLOB 구조를 검색하는 데 사용됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | nsemail.h |