admin
base
com
developer
drivers
ds
adsi
dns
ds
edb500
ese98
inc
nameres
netapi
nlrepl
nw
published
safealloca
security
asn1
authz
azroles
base
common
cryptoapi
csps
dsrole
gina
inc
lib
ntmarta
passport
protocols
services
ca
capesnpn
celib
certadm
certcli
certclib
certdb
certenc
certif
certlib
certmmc
certprxy
certreq
certsrv
certview
certweb
certwrap
docs
exit
genreq
hdrs
idl
com
certadm.idl
certbase.idl
certbcli.idl
certcli.idl
certdb.idl
certenc.idl
certexit.idl
certif.idl
certmod.idl
certpol.idl
certsrvd.idl
certview.idl
esent.idl
makefile
makefile.inc
sources
dcom
rpc
tlb
dirs
include
initlib
nsrevchk
ocmsetup
policy
requests
tools
dirs
makefile.sdk
mkallstr.bat
msaudite.mc
scerpc
smartcrd
w32time
dirs
tools
winsafer
dirs
roadmap.txt
win32
xpress
dirs
project.mk
enduser
inetcore
inetsrv
loc
mergedcomponents
multimedia
net
printscan
public
published
sdktools
shell
termsrv
tools
windows
dirs
makefil0
415 lines
15 KiB
Plaintext
415 lines
15 KiB
Plaintext
//+--------------------------------------------------------------------------
|
|
//
|
|
// Microsoft Windows
|
|
// Copyright (C) Microsoft Corporation, 1996 - 1999
|
|
//
|
|
// File: certcli.idl
|
|
//
|
|
// Contents: IDL source for certcli.dll
|
|
//
|
|
//---------------------------------------------------------------------------
|
|
|
|
// This file will be processed by the MIDL tool to produce the type library
|
|
// (certcli.tlb) and marshalling code.
|
|
|
|
import "wtypes.idl";
|
|
import "certif.idl";
|
|
import "oaidl.idl";
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertGetConfig -- local COM interface, local implementation
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
object,
|
|
uuid(c7ea09c0-ce17-11d0-8833-00a0c903b83c),
|
|
dual,
|
|
helpstring("ICertGetConfig Interface"),
|
|
pointer_default(unique)
|
|
]
|
|
|
|
interface ICertGetConfig: IDispatch
|
|
{
|
|
HRESULT GetConfig(
|
|
[in] LONG Flags,
|
|
[out, retval] BSTR *pstrOut);
|
|
};
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertConfig::GetField()
|
|
// strFieldName parameter values:
|
|
|
|
cpp_quote("#define wszCONFIG_COMMONNAME L\"CommonName\"")
|
|
cpp_quote("#define wszCONFIG_ORGUNIT L\"OrgUnit\"")
|
|
cpp_quote("#define wszCONFIG_ORGANIZATION L\"Organization\"")
|
|
cpp_quote("#define wszCONFIG_LOCALITY L\"Locality\"")
|
|
cpp_quote("#define wszCONFIG_STATE L\"State\"")
|
|
cpp_quote("#define wszCONFIG_COUNTRY L\"Country\"")
|
|
cpp_quote("#define wszCONFIG_CONFIG L\"Config\"")
|
|
cpp_quote("#define wszCONFIG_EXCHANGECERTIFICATE L\"ExchangeCertificate\"")
|
|
cpp_quote("#define wszCONFIG_SIGNATURECERTIFICATE L\"SignatureCertificate\"")
|
|
cpp_quote("#define wszCONFIG_DESCRIPTION L\"Description\"")
|
|
cpp_quote("#define wszCONFIG_COMMENT L\"Comment\" // obsolete: use Description")
|
|
cpp_quote("#define wszCONFIG_SERVER L\"Server\"")
|
|
cpp_quote("#define wszCONFIG_AUTHORITY L\"Authority\"")
|
|
cpp_quote("#define wszCONFIG_SANITIZEDNAME L\"SanitizedName\"")
|
|
cpp_quote("#define wszCONFIG_SHORTNAME L\"ShortName\"")
|
|
cpp_quote("#define wszCONFIG_SANITIZEDSHORTNAME L\"SanitizedShortName\"")
|
|
cpp_quote("#define wszCONFIG_FLAGS L\"Flags\"")
|
|
|
|
|
|
// Flags setting
|
|
const LONG CAIF_DSENTRY = 0x00000001; // bit set for CA from DS
|
|
const LONG CAIF_SHAREDFOLDERENTRY = 0x00000002; // CA from shared folder
|
|
const LONG CAIF_REGISTRY = 0x00000004; // CA from local registry
|
|
const LONG CAIF_LOCAL = 0x00000008; // local CA
|
|
const LONG CAIF_REGISTRYPARENT = 0x00000010; // CA parent from registry
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertConfig -- local COM interface, local implementation
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
object,
|
|
uuid(372fce34-4324-11d0-8810-00a0c903b83c),
|
|
dual,
|
|
helpstring("ICertConfig Interface"),
|
|
pointer_default(unique)
|
|
]
|
|
|
|
interface ICertConfig: IDispatch
|
|
{
|
|
HRESULT Reset(
|
|
[in] LONG Index,
|
|
[out, retval] LONG *pCount);
|
|
|
|
HRESULT Next(
|
|
[out, retval] LONG *pIndex);
|
|
|
|
HRESULT GetField(
|
|
[in] BSTR const strFieldName,
|
|
[out, retval] BSTR *pstrOut);
|
|
|
|
HRESULT GetConfig(
|
|
[in] LONG Flags,
|
|
[out, retval] BSTR *pstrOut);
|
|
};
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertConfig2 -- local COM interface, local implementation
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
object,
|
|
uuid(7a18edde-7e78-4163-8ded-78e2c9cee924),
|
|
dual,
|
|
helpstring("ICertConfig2 Interface"),
|
|
pointer_default(unique)
|
|
]
|
|
|
|
interface ICertConfig2: ICertConfig
|
|
{
|
|
HRESULT SetSharedFolder(
|
|
[in] BSTR const strSharedFolder);
|
|
};
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest::Submit()
|
|
// Flags for request and attributes encoding and type:
|
|
|
|
const LONG CR_IN_BASE64HEADER = 0x00000000; // BASE64 with begin/end
|
|
const LONG CR_IN_BASE64 = 0x00000001; // BASE64 w/o begin/end
|
|
const LONG CR_IN_BINARY = 0x00000002; // binary request
|
|
const LONG CR_IN_ENCODEANY = 0x000000ff; // Could be any of the above
|
|
const LONG CR_IN_ENCODEMASK = 0x000000ff; // request encoding mask
|
|
|
|
const LONG CR_IN_FORMATANY = 0x00000000; // Could be any of the below
|
|
const LONG CR_IN_PKCS10 = 0x00000100; // PKCS 10 request
|
|
const LONG CR_IN_KEYGEN = 0x00000200; // Keygen request
|
|
const LONG CR_IN_PKCS7 = 0x00000300; // PKCS 7 renewal request
|
|
const LONG CR_IN_CMC = 0x00000400; // CMC request
|
|
const LONG CR_IN_FORMATMASK = 0x0000ff00; // request format mask
|
|
|
|
// Cert Server 1.0 obsolete encryption bits:
|
|
//const LONG CR_IN_ENCRYPTED_REQUEST = 0x00010000; // request encrypted
|
|
//const LONG CR_IN_ENCRYPTED_ATTRIBUTES = 0x00020000; // attributes encrypted
|
|
const LONG CR_IN_RPC = 0x00020000; // Use RPC instead of DCOM
|
|
const LONG CR_IN_FULLRESPONSE = 0x00040000; // Return CMC Full Response
|
|
const LONG CR_IN_CRLS = 0x00080000; // include current CRLs
|
|
|
|
// Flags for GetConfig flag
|
|
const LONG CC_DEFAULTCONFIG = 0x00000000; // ask to get 1st pingable CA
|
|
const LONG CC_UIPICKCONFIG = 0x00000001; // invoke UI to pick CA
|
|
const LONG CC_FIRSTCONFIG = 0x00000002; // pick first CA
|
|
const LONG CC_LOCALCONFIG = 0x00000003; // pick local CA
|
|
const LONG CC_LOCALACTIVECONFIG = 0x00000004; // pick local pingable CA
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest::Submit(), ICertRequest::RetrievePending() and
|
|
// returned Disposition:
|
|
|
|
const LONG CR_DISP_INCOMPLETE = 0x00000000; // request did not complete
|
|
const LONG CR_DISP_ERROR = 0x00000001; // request failed
|
|
const LONG CR_DISP_DENIED = 0x00000002; // request denied
|
|
const LONG CR_DISP_ISSUED = 0x00000003; // cert issued
|
|
const LONG CR_DISP_ISSUED_OUT_OF_BAND = 0x00000004; // cert issued separately
|
|
const LONG CR_DISP_UNDER_SUBMISSION = 0x00000005; // taken under submission
|
|
const LONG CR_DISP_REVOKED = 0x00000006; // issued and revoked
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest::GetCACertificate(),
|
|
// ICertRequest::GetCertificate(),
|
|
// ICertAdmin::GetCRL(),
|
|
// ICertRequest2::GetCAProperty(),
|
|
// ICertAdmin2::GetCAProperty()
|
|
// ICertRequest2::GetFullResponseProperty(),
|
|
// Flags for certificate encoding:
|
|
|
|
const LONG CR_OUT_BASE64HEADER = 0x00000000; // BASE64 with begin/end
|
|
const LONG CR_OUT_BASE64 = 0x00000001; // BASE64 w/o begin/end
|
|
const LONG CR_OUT_BINARY = 0x00000002; // binary certificate
|
|
const LONG CR_OUT_ENCODEMASK = 0x000000ff; // certificate encoding mask
|
|
const LONG CR_OUT_CHAIN = 0x00000100; // return certificate chain
|
|
const LONG CR_OUT_CRLS = 0x00000200; // chain with current CRLs
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest2::GetErrorMessageText() Flags
|
|
|
|
const LONG CR_GEMT_HRESULT_STRING = 0x00000001; // Append "0xXX (Win32: DD)"
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest2::GetCAProperty(), ICertAdmin2::GetCAProperty() PropId
|
|
|
|
cpp_quote("#define CR_PROP_NONE 0 // Invalid")
|
|
cpp_quote("#define CR_PROP_FILEVERSION 1 // String")
|
|
cpp_quote("#define CR_PROP_PRODUCTVERSION 2 // String")
|
|
cpp_quote("#define CR_PROP_EXITCOUNT 3 // Long")
|
|
cpp_quote("#define CR_PROP_EXITDESCRIPTION 4 // String, Indexed")
|
|
cpp_quote("#define CR_PROP_POLICYDESCRIPTION 5 // String")
|
|
cpp_quote("#define CR_PROP_CANAME 6 // String")
|
|
cpp_quote("#define CR_PROP_SANITIZEDCANAME 7 // String")
|
|
cpp_quote("#define CR_PROP_SHAREDFOLDER 8 // String")
|
|
cpp_quote("#define CR_PROP_PARENTCA 9 // String")
|
|
|
|
cpp_quote("#define CR_PROP_CATYPE 10 // Long")
|
|
cpp_quote("#define CR_PROP_CASIGCERTCOUNT 11 // Long")
|
|
cpp_quote("#define CR_PROP_CASIGCERT 12 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CASIGCERTCHAIN 13 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CAXCHGCERTCOUNT 14 // Long")
|
|
cpp_quote("#define CR_PROP_CAXCHGCERT 15 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CAXCHGCERTCHAIN 16 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_BASECRL 17 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_DELTACRL 18 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CACERTSTATE 19 // Long, Indexed")
|
|
cpp_quote("#define CR_PROP_CRLSTATE 20 // Long, Indexed")
|
|
cpp_quote("#define CR_PROP_CAPROPIDMAX 21 // Long")
|
|
cpp_quote("#define CR_PROP_DNSNAME 22 // String")
|
|
cpp_quote("#define CR_PROP_ROLESEPARATIONENABLED 23 // Long")
|
|
cpp_quote("#define CR_PROP_KRACERTUSEDCOUNT 24 // Long")
|
|
cpp_quote("#define CR_PROP_KRACERTCOUNT 25 // Long")
|
|
cpp_quote("#define CR_PROP_KRACERT 26 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_KRACERTSTATE 27 // Long, Indexed")
|
|
cpp_quote("#define CR_PROP_ADVANCEDSERVER 28 // Long")
|
|
cpp_quote("#define CR_PROP_TEMPLATES 29 // String")
|
|
cpp_quote("#define CR_PROP_BASECRLPUBLISHSTATUS 30 // Long, Indexed")
|
|
cpp_quote("#define CR_PROP_DELTACRLPUBLISHSTATUS 31 // Long, Indexed")
|
|
cpp_quote("#define CR_PROP_CASIGCERTCRLCHAIN 32 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CAXCHGCERTCRLCHAIN 33 // Binary, Indexed")
|
|
cpp_quote("#define CR_PROP_CACERTSTATUSCODE 34 // Long, Indexed")
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest2::GetFullResponseProperty() PropId
|
|
|
|
cpp_quote("#define FR_PROP_NONE 0 // Invalid")
|
|
cpp_quote("#define FR_PROP_FULLRESPONSE 1 // Binary")
|
|
cpp_quote("#define FR_PROP_STATUSINFOCOUNT 2 // Long")
|
|
cpp_quote("#define FR_PROP_BODYPARTSTRING 3 // String, Indexed")
|
|
cpp_quote("#define FR_PROP_STATUS 4 // Long, Indexed")
|
|
cpp_quote("#define FR_PROP_STATUSSTRING 5 // String, Indexed")
|
|
cpp_quote("#define FR_PROP_OTHERINFOCHOICE 6 // Long, Indexed")
|
|
cpp_quote("#define FR_PROP_FAILINFO 7 // Long, Indexed")
|
|
cpp_quote("#define FR_PROP_PENDINFOTOKEN 8 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_PENDINFOTIME 9 // Date, Indexed")
|
|
cpp_quote("#define FR_PROP_ISSUEDCERTIFICATEHASH 10 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_ISSUEDCERTIFICATE 11 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_ISSUEDCERTIFICATECHAIN 12 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_ISSUEDCERTIFICATECRLCHAIN 13 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_ENCRYPTEDKEYHASH 14 // Binary, Indexed")
|
|
cpp_quote("#define FR_PROP_FULLRESPONSENOPKCS7 15 // Binary")
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest -- local COM interface, implementation uses DCOM
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
object,
|
|
uuid(014e4840-5523-11d0-8812-00a0c903b83c),
|
|
dual,
|
|
helpstring("ICertRequest Interface"),
|
|
pointer_default(unique)
|
|
]
|
|
|
|
interface ICertRequest: IDispatch
|
|
{
|
|
HRESULT Submit(
|
|
[in] LONG Flags,
|
|
[in] BSTR const strRequest,
|
|
[in] BSTR const strAttributes,
|
|
[in] BSTR const strConfig,
|
|
[out, retval] LONG *pDisposition);
|
|
|
|
HRESULT RetrievePending(
|
|
[in] LONG RequestId,
|
|
[in] BSTR const strConfig,
|
|
[out, retval] LONG *pDisposition);
|
|
|
|
HRESULT GetLastStatus(
|
|
[out, retval] LONG *pStatus);
|
|
|
|
HRESULT GetRequestId(
|
|
[out, retval] LONG *pRequestId);
|
|
|
|
HRESULT GetDispositionMessage(
|
|
[out, retval] BSTR *pstrDispositionMessage);
|
|
|
|
HRESULT GetCACertificate(
|
|
[in] LONG fExchangeCertificate,
|
|
[in] BSTR const strConfig,
|
|
[in] LONG Flags, // CR_OUT_*
|
|
[out, retval] BSTR *pstrCertificate);
|
|
|
|
HRESULT GetCertificate(
|
|
[in] LONG Flags, // CR_OUT_*
|
|
[out, retval] BSTR *pstrCertificate);
|
|
};
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// ICertRequest2 -- local COM interface, implementation uses DCOM
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
object,
|
|
uuid(a4772988-4a85-4fa9-824e-b5cf5c16405a),
|
|
dual,
|
|
helpstring("ICertRequest2 Interface"),
|
|
pointer_default(unique)
|
|
]
|
|
|
|
interface ICertRequest2: ICertRequest
|
|
{
|
|
HRESULT GetIssuedCertificate(
|
|
[in] BSTR const strConfig,
|
|
[in] LONG RequestId, // -1: use strSerialNumber
|
|
[in] BSTR const strSerialNumber, // OPTIONAL
|
|
[out, retval] LONG *pDisposition);
|
|
|
|
HRESULT GetErrorMessageText(
|
|
[in] LONG hrMessage,
|
|
[in] LONG Flags,
|
|
[out, retval] BSTR *pstrErrorMessageText);
|
|
|
|
HRESULT GetCAProperty(
|
|
[in] BSTR const strConfig,
|
|
[in] LONG PropId, // CR_PROP_*
|
|
[in] LONG PropIndex,
|
|
[in] LONG PropType, // PROPTYPE_*
|
|
[in] LONG Flags, // CR_OUT_*
|
|
[out, retval] VARIANT *pvarPropertyValue);
|
|
|
|
HRESULT GetCAPropertyFlags(
|
|
[in] BSTR const strConfig,
|
|
[in] LONG PropId, // CR_PROP_*
|
|
[out, retval] LONG *pPropFlags); // PROPTYPE_* | PROPFLAGS_*
|
|
|
|
HRESULT GetCAPropertyDisplayName(
|
|
[in] BSTR const strConfig,
|
|
[in] LONG PropId, // CR_PROP_*
|
|
[out, retval] BSTR *pstrDisplayName);
|
|
|
|
HRESULT GetFullResponseProperty(
|
|
[in] LONG PropId, // FR_PROP_*
|
|
[in] LONG PropIndex,
|
|
[in] LONG PropType, // PROPTYPE_*
|
|
[in] LONG Flags, // CR_OUT_*
|
|
[out, retval] VARIANT *pvarPropertyValue);
|
|
};
|
|
|
|
|
|
//+--------------------------------------------------------------------------
|
|
// certcli Type library
|
|
//+--------------------------------------------------------------------------
|
|
|
|
[
|
|
uuid(372fce32-4324-11d0-8810-00a0c903b83c),
|
|
version(1.0),
|
|
helpstring("CertCli 1.0 Type Library")
|
|
]
|
|
|
|
library CERTCLIENTLib
|
|
{
|
|
importlib("stdole2.tlb");
|
|
|
|
//------------------------------------------------
|
|
// CCertGetConfig
|
|
[
|
|
uuid(c6cc49b0-ce17-11d0-8833-00a0c903b83c),
|
|
helpstring("CertGetConfig Class")
|
|
]
|
|
coclass CCertGetConfig
|
|
{
|
|
[default] interface ICertGetConfig;
|
|
};
|
|
|
|
//------------------------------------------------
|
|
// CCertConfig
|
|
[
|
|
uuid(372fce38-4324-11d0-8810-00a0c903b83c),
|
|
helpstring("CertConfig Class")
|
|
]
|
|
coclass CCertConfig
|
|
{
|
|
[default] interface ICertConfig2;
|
|
};
|
|
|
|
//------------------------------------------------
|
|
// CCertRequest
|
|
[
|
|
uuid(98aff3f0-5524-11d0-8812-00a0c903b83c),
|
|
helpstring("CertRequest Class")
|
|
]
|
|
coclass CCertRequest
|
|
{
|
|
[default] interface ICertRequest2;
|
|
};
|
|
|
|
//------------------------------------------------
|
|
// CCertServerPolicy
|
|
[
|
|
uuid(aa000926-ffbe-11cf-8800-00a0c903b83c),
|
|
helpstring("CertServerPolicy Class")
|
|
]
|
|
coclass CCertServerPolicy
|
|
{
|
|
[default] interface ICertServerPolicy;
|
|
};
|
|
|
|
//------------------------------------------------
|
|
// CCertServerExit
|
|
[
|
|
uuid(4c4a5e40-732c-11d0-8816-00a0c903b83c),
|
|
helpstring("CertServerExit Class")
|
|
]
|
|
coclass CCertServerExit
|
|
{
|
|
[default] interface ICertServerExit;
|
|
};
|
|
};
|