ICertConfig::Next method (certcli.h)

The Next method retrieves the index of the next available Certificate Services server configuration in the configuration point. This method was first defined in the ICertConfig interface.

Syntax

HRESULT Next(
  [out] LONG *pIndex
);

Parameters

[out] pIndex

A pointer to a Long variable that will contain the index of the enumerated configuration, or –1 if there are no more configurations to enumerate.

Return value

C++

If the method succeeds, the method returns S_OK, and the pIndex parameter contains the index of the enumerated configuration. If there are no more configurations to enumerate, the return value is S_FALSE, and the pIndex parameter points to a value of –1.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

Returns a value that specifies the index of the next available Certificate Services server configuration in the configuration point. If no more configurations are available, the method returns a value of –1.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header certcli.h (include Certsrv.h)
Library Certidl.lib
DLL Certcli.dll

See also

ICertConfig

ICertConfig2

Reset