NAPI_PROVIDER_LEVEL 열거형(nsemail.h)

아티클
08/25/2023

NAPI_PROVIDER_LEVEL 열거형은 지정된 도메인에 대한 NS_EMAIL 네임스페이스 공급자의 공급자 권한 수준을 지정합니다.

Syntax

typedef enum napi_provider_level_tag {
  ProviderLevel_None = 0,
  ProviderLevel_Secondary,
  ProviderLevel_Primary
} NAPI_PROVIDER_LEVEL;

상수


`ProviderLevel_None` 값: 0 네임스페이스 공급자는 현재 도메인을 지원하지 않습니다. 이 값은 지원되는 도메인 목록에서 도메인을 제거하지 않고 도메인에 대한 지원을 일시적으로 해제하는 데 사용할 수 있습니다. 공급자가 설치 및 등록될 때 지정된 도메인에 대한 NAPI_DOMAIN_DESCRIPTION_BLOB AuthLevel 멤버에 ProviderLevel_None 설정된 경우 공급자가 와일드카드 공급자로 등록되지 않는 한 네임스페이스 공급자가 해당 도메인에 주소를 resolve 등록하도록 호출되지 않습니다. 값이 ProviderLevel_None 도메인에 대한 여러 NS_EMAIL 네임스페이스 공급자가 있을 수 있습니다. 와일드카드 공급자로도 등록된 이 값을 가진 네임스페이스 공급자가 있는 경우 공급자는 Winsock 카탈로그에 표시되는 순서대로 호출됩니다.
`ProviderLevel_Secondary` 네임스페이스 공급자는 NS_EMAIL 네임스페이스의 도메인에 대한 보조 공급자입니다. 공급자가 이 도메인에 대한 NS_EMAIL 이름을 resolve 등록하고 주 공급자가 제공하는 것과 동일한 답변을 제공할 수 있는 경우 네임스페이스 공급자는 대상 도메인의 보조 공급자가 될 수 있습니다. 공급자가 설치 및 등록될 때 지정된 도메인에 대한 NAPI_DOMAIN_DESCRIPTION_BLOB AuthLevel 멤버에 ProviderLevel_Secondary 설정된 경우 도메인의 주 공급자를 현재 사용할 수 없거나 주 공급자가 해당 도메인에 주소를 resolve 또는 등록할 수 없는 경우 이 공급자가 호출됩니다. 값이 ProviderLevel_Secondary 도메인에 대한 여러 보조 NS_EMAIL 네임스페이스 공급자가 있을 수 있습니다. 보조 네임스페이스 공급자가 여러 명 있는 경우 공급자는 Winsock 카탈로그에 표시되는 순서대로 호출됩니다.
`ProviderLevel_Primary` 네임스페이스 공급자는 NS_EMAIL 네임스페이스의 도메인에 대한 기본 공급자입니다. 네임스페이스 공급자는 해당 도메인에 대한 모든 NS_EMAIL 이름을 소유하고 있으므로 이러한 모든 이름의 master 데이터에 액세스할 수 있는 경우 도메인의 기본 공급자라고 주장할 수 있습니다. 로컬 시스템에 등록된 도메인에 대한 단일 기본 NS_EMAIL 네임스페이스 공급자만 있어야 합니다. 참고 동일한 도메인의 기본 공급자라고 주장하는 두 개의 NS_EMAIL 네임스페이스 공급자가 없어야 합니다. 여러 공급자가 동일한 도메인에 대한 기본 공급자로 등록하려고 하면 도메인의 Winsock 네임스페이스 카탈로그에 있는 첫 번째 공급자가 주 공급자로 호출됩니다. 주 공급자인 다른 모든 공급자 클레임은 무시됩니다.

설명

이 열거형은 Windows Vista 이상에서 지원됩니다.

NAPI_PROVIDER_LEVEL 열거형은 NAPI_DOMAIN_DESCRIPTION_BLOB 구조체에서 도메인에 대한 NS_EMAIL 네임스페이스 공급자의 권한 수준을 지정하는 데 사용됩니다. NS_EMAIL 네임스페이스에 등록된 각 네임스페이스 공급자는 여러 도메인을 지원할 수 있습니다. 지원되는 도메인 목록은 공급자 등록 Blob에서 NAPI_DOMAIN_DESCRIPTION_BLOB 구조 목록으로 지정됩니다. 지원되는 각 도메인 사양에는 해당 도메인에 대해 공급자가 제공하는 지원 유형을 설명하는 NAPI_DOMAIN_DESCRIPTION_BLOB AuthLevel 멤버의 NAPI_PROVIDER_LEVEL 값이 포함되어 있습니다.

지정된 도메인 외에도 NS_EMAIL 네임스페이스 공급자는 공급자가 설치될 때 전달된 NAPI_PROVIDER_INSTALLATION_BLOB fSupportsWildCard 멤버를 0이 아닌 값으로 지정하여 모든 도메인을 시도하고 지원하기 위해 와일드카드 공급자로 등록할 수 있습니다.

네임스페이스 공급자는 도메인에 주소를 resolve 등록하기 위해 다음 순서로 호출됩니다. 도메인의 기본 공급자로 등록된 네임스페이스 공급자를 먼저 호출합니다. 네임스페이스 쿼리에서 신뢰할 수 있는 결과가 요청되는지 여부에 따라 두 가지 경우가 있습니다. 쿼리의 기본값은 신뢰할 수 있는 결과를 요청하는 것입니다.

쿼리에서 신뢰할 수 있는 결과가 요청되면 네임스페이스 공급자가 다음과 같이 호출됩니다. 주 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 첫 번째 보조 공급자가 호출됩니다. 보조 공급자를 사용할 수 없거나 주소를 resolve 또는 등록할 수 없는 경우 Winsock 카탈로그의 다음 보조 공급자가 호출됩니다. 모든 보조 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 첫 번째 와일드카드 공급자가 호출됩니다. 첫 번째 와일드카드 공급자를 사용할 수 없거나 주소를 resolve 등록할 수 없는 경우 Winsock 카탈로그의 다음 와일드카드 공급자가 호출됩니다.

쿼리에서 신뢰할 수 없는 결과가 요청되면 네임스페이스 공급자가 다음과 같이 호출됩니다. 주 공급자, 모든 보조 공급자 및 모든 와일드카드 공급자가 호출되고 모든 쿼리의 결과가 반환됩니다. 주 공급자를 먼저 호출합니다. 보조 공급자는 Winsock 카탈로그의 순서에 따라 다음에 호출됩니다. 와일드카드 공급자는 Winsock 카탈로그의 순서에 따라 다음에 호출됩니다. 반환되는 결과는 쿼리 순서를 기반으로 합니다.

NAPI_DOMAIN_DESCRIPTION_BLOB 구조체는 NAPI_PROVIDER_INSTALLATION_BLOB 구조체에서 NS_EMAIL 네임스페이스 공급자를 설명하는 데 사용됩니다.

WSCInstallNameSpaceEx 및 WSCInstallNameSpaceEx32 함수는 NAPI_PROVIDER_INSTALLATION_BLOB 구조를 사용하여 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자를 설치하는 데 사용됩니다.

WSAEnumNameSpaceProvidersEx 및 WSCEnumNameSpaceProvidersEx32 함수는 NS_EMAIL 네임스페이스에 대한 네임스페이스 공급자를 열거하고 공급자에 대한 NAPI_PROVIDER_INSTALLATION_BLOB 구조를 검색하는 데 사용됩니다.

요구 사항

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