MessageQueue.EncryptionRequired 속성

정의

큐에서 프라이빗하지 않은(암호화되지 않은) 메시지만 허용하는지 여부를 나타내는 값을 가져오거나 설정합니다.

public:
 property System::Messaging::EncryptionRequired EncryptionRequired { System::Messaging::EncryptionRequired get(); void set(System::Messaging::EncryptionRequired value); };
[System.Messaging.MessagingDescription("MQ_EncryptionRequired")]
public System.Messaging.EncryptionRequired EncryptionRequired { get; set; }
[<System.Messaging.MessagingDescription("MQ_EncryptionRequired")>]
member this.EncryptionRequired : System.Messaging.EncryptionRequired with get, set
Public Property EncryptionRequired As EncryptionRequired

속성 값

EncryptionRequired 값 중 하나입니다. 기본값은 None입니다.

특성

예외

메시지 큐 메서드에 액세스하는 동안 오류가 발생한 경우

예제

다음 코드 예제에서는 메시지 큐 EncryptionRequired 의 속성 값을 가져오고 설정합니다.

// Set the queue's EncryptionRequired property value.
queue.EncryptionRequired = System.Messaging.EncryptionRequired.Optional;

// Display the new value of the queue's EncryptionRequired property.
Console.WriteLine("MessageQueue.EncryptionRequired: {0}",
    queue.EncryptionRequired);

설명

큐로 전송되는 메시지에 암호화가 필요하도록 지정하면 메시지 본문만 암호화됩니다. 다른 멤버(예: LabelSenderId 속성)는 암호화할 수 없습니다.

이 속성을 설정하면 메시지 큐 큐가 수정되었습니다. 따라서 다른 MessageQueue 인스턴스는 변경의 영향을 받습니다.

메시지를 암호화하면 메시지를 비공개로 만듭니다. 큐의 암호화 요구 사항을 None, 또는 BodyOptional 속성을 적절하게 설정 EncryptionRequired 하여 지정할 수 있습니다. 메시지 설정은 UseEncryption 큐의 암호화 요구 사항에 해당해야 합니다. 메시지가 암호화되지 않았지만 큐가 을 Body지정하거나 메시지가 암호화되었지만 큐가 를 지정 None하는 경우 메시지는 큐에 의해 거부됩니다. 이 이벤트의 부정 승인 메시지를 요청 하는 송신 애플리케이션 메시지 큐는 보내는 애플리케이션 메시지의 거부를 나타냅니다. 속성true이 이 UseDeadLetterQueue 면 암호화에 실패한 메시지가 배달 못한 편지 큐로 전송됩니다. 그렇지 않으면 메시지가 손실됩니다.

다음 표에서는 이 속성을 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.

작업 그룹 모드 사용 가능
수집 Yes
로컬 컴퓨터 및 직접 형식 이름 Yes
원격 컴퓨터 No
원격 컴퓨터 및 직접 형식 이름 No

적용 대상

추가 정보