NAPI_PROVIDER_INSTALLATION_BLOB 구조체(nsemail.h)

아티클
08/25/2023

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