Export (0) Print
Expand All

ICEnroll4::EnableT61DNEncoding property

[This property is no longer available for use as of Windows Server 2008 and Windows Vista.]

The EnableT61DNEncoding property sets or retrieves a Boolean value that determines whether the distinguished name in the request is encoded as a T61 string instead of as a Unicode string.

A T61 character is 8 bits, hence all Unicode characters to be encoded must be less than or equal to 0xFF. This property was first defined in the ICEnroll2 interface.

This property is read/write.

Syntax


HRESULT put_EnableT61DNEncoding(
  [in]   BOOL bValue
);

HRESULT get_EnableT61DNEncoding(
  [out]  BOOL *pbValue
);

Property value

If TRUE, the distinguished name in the request is encoded as a T61 string instead of as a Unicode string.

Error codes

If the property access methods put_EnableT61DNEncoding and get_EnableT61DNEncoding succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

The EnableT61DNEncoding property affects the behavior of the following methods:

Examples


BOOL     bT61DN;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll2 interface pointer.
// Get the EnableT61DNEncoding Boolean value.

hr = pEnroll->get_EnableT61DNEncoding( &bT61DN );
if ( FAILED ( hr ) )
    printf("Failed get_EnableT61DNEncoding - %x\n", hr );
else
    printf( "T61DNEncoding: %s\n", 
             ( bT61DN ? "Enabled" : "Disabled" ) );


// Set the EnableT61DNEncoding value.

hr = pEnroll->put_EnableT61DNEncoding( TRUE );
if ( FAILED ( hr ) )
    printf("Failed Setting EnableT61DNEncoding - %x\n", hr );
else
    printf( "EnableT61DNEncoding was set to TRUE\n" );

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_ICEnroll4 is defined as c1f1188a-2eb5-4a80-841b-7e729a356d90

 

 

Community Additions

ADD
Show:
© 2014 Microsoft