ICEnroll3::p ut_LimitExchangeKeyToEncipherment 方法 (xenroll.h)
[自 Windows Server 2008 和 Windows Vista 起,這個屬性不再可供使用。
LimitExchangeKeyToEncipherment屬性會設定或擷取布林值,這個值會決定AT_KEYEXCHANGE要求是否包含數位簽章和非強制金鑰使用方式。
此屬性最初是在 ICEnroll3 介面中引進。
這是可讀寫的屬性。
語法
HRESULT put_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 |