Windows Dev Center

IEnroll4::SPCFileNameWStr property

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

The SPCFileNameWStr property sets or retrieves the name of the file to which to write the base64-encoded PKCS #7 (in BSTR form) as returned from the certification authority.

This property was first defined in the IEnroll interface.

This property is read/write.

Syntax


HRESULT put_SPCFileNameWStr(
  [in]  LPWSTR szwSPCFileName
);

HRESULT get_SPCFileNameWStr(
  [out] LPWSTR *pszwSPCFileName
);

Property value

A pointer to a null-terminated wide character string that contains the SPC file name. The string can be any valid file name supported by the operating system.

Error codes

If the property access methods put_SPCFileNameWStr and get_SPCFileNameWStr succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

The file is written as a binary PKCS #7. Specifying this file does not affect the acceptance of the certificates into any of the user's stores.

If the file already exists, the user is notified and prompted for permission to overwrite it.

SPCFileNameWStr affects the behavior of the following methods:

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_IEnroll4 is defined as f8053fe5-78f4-448f-a0db-41d61b73446b

See also

IEnroll4

 

 

Community Additions

ADD
Show:
© 2015 Microsoft