ICertManageModule::Configure

[This is preliminary documentation and subject to change.]

The Configure method displays the module user interface.

[VB] Configure(
  String strConfig
);

 
[JAVA] Configure(
  java.lang.String strConfig
);

 
[C++] HRESULT Configure(
  BSTR const strConfig  // in
);

 

Parameters

strConfig

Value representing the Certificate Server to be configured. The text in strConfig is the name of the Certificate Server. Note that the name of the Certificate Server is identical to the common name entered during the Certificate Server setup process unless the common name contains characters which are not allowed for file names, registry keys, or registry values. In the event the common name contains any unallowable characters, strConfig is a modified name of the common name (modified to not contain any of the unallowable characters).

Return Values

[C++] The return value is an HRESULT. A value of S_OK indicates success.

Remarks

The Configure method displays the module user interface, allowing the user to view and change the module's configurable items.

Example

HRESULT             hr;
BSTR                strCertServ = NULL;
ICertManageModule * pIManageModule = NULL;

// instantiate ICertManageModule object
hr = CoCreateInstance(
          myClsid,
          NULL,
          CLSCTX_INPROC_SERVER,
          IID_ICertManageModule,
          (void **) &pIManageModule);
if ( FAILED( hr ) )
{
    printf("Unable to instantiate ICertManageModule object\n");
    goto error;
}

bstrCertServ = SysAllocString("MyCertServ");
// display the configuration interface
hr = pIManageModule->Configure( bstrCertServ );
if ( S_OK == hr )
{
    // user interface is displayed...
}
else
    printf("ICertManageModule::Configure failed with code %x\n", hr);

error:
// free resources when done
if ( NULL != bstrCertServ )
    SysFreeString( bstrCertServ );
if ( NULL != pIManageModule )
    pIManageModule->Release();
 

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certmod.h.
  Import Library: Use certidl.lib.