ICEnroll3：：get_LimitExchangeKeyToEncipherment 方法 (xenroll.h)

發行項
03/13/2024

[自 Windows Server 2008 和 Windows Vista 起，這個屬性已不再可供使用。]

LimitExchangeKeyToEncipherment 屬性會設定或擷取 Boolean 值，以判斷AT_KEYEXCHANGE要求是否包含數位簽名和非可否認性密鑰使用方式。

此屬性最初是在 ICEnroll3 介面中引進。

這是可讀寫的屬性。

語法

HRESULT get_LimitExchangeKeyToEncipherment(
  BOOL *fLimitExchangeKeyToEncipherment
);

參數

fLimitExchangeKeyToEncipherment

傳回值

無

備註

此屬性是布爾值，只會影響AT_KEYEXCHANGE要求。這不會影響AT_SIGNATURE要求。

如果此屬性的值為 false，AT_KEYEXCHANGE要求將包含下列密鑰使用方式：

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE
CERT_DIGITAL_SIGNATURE_KEY_USAGE
CERT_NON_REPUDIATION_KEY_USAGE

如果此屬性的值為 true，則AT_KEYEXCHANGE要求將包含下列密鑰使用方式：

CERT_DATA_ENCIPHERMENT_KEY_USAGE
CERT_KEY_ENCIPHERMENT_KEY_USAGE

範例

// Get the LimitExchangeKeyToEncipherment value.
BOOL       bLimitKey;
HRESULT    hr;
// pEnroll is previously instantiated ICEnroll interface pointer.
hr = pEnroll->get_LimitExchangeKeyToEncipherment(&bLimitKey);
if (FAILED(hr))
    printf("Failed get_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf("LimitExchangeKeyToEncipherment: %s\n",
          ( bLimitKey ? "TRUE" : "FALSE"));

// Set the LimitExchangeKeyToEncipherment value.
hr = pEnroll->put_LimitExchangeKeyToEncipherment( TRUE );
if ( FAILED ( hr ) )
    printf("Failed put_LimitExchangeKeyToEncipherment - %x\n", hr );
else
    printf( "LimitExchangeKeyToEncipherment was set to TRUE\n" );

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	xenroll.h
程式庫	Uuid.lib
Dll	Xenroll.dll