3.10.4.6 RetrieveClusterCert (Opnum 10)

  • Article

The RetrieveClusterCert method SHOULD<35> return the certificate and cluster secret stored on the server.

    HRESULT RetrieveClusterCert(
      [out] CLUSTER_CERT * ClusterCert
    );

ClusterCert: The certificate and cluster secret for the cluster that is stored in the node. The CLUSTER_CERT structure is defined in section 2.2.23.

Return Values: A signed 32-bit value that indicates return status. If the method returns a negative value, it has failed. Zero or positive values indicate success, with the lower 16 bits in positive nonzero values containing warnings or flags defined in the method implementation. For more information about Win32 error codes and HRESULT values, see [MS-ERREF] section 2.1 and section 2.2.

Return value/code

Description

0x00000000

S_OK

The call was successful.

0x80070002

ERROR_FILE_NOT_FOUND

The certificate or cluster secret has not yet been configured by a previous call to RetrieveClusterCert.

For any other condition, this method MUST return a value that is not one of the values listed in the preceding table. The client MUST behave in a consistent, identical manner for all values that are not listed in the preceding table.

Exceptions Thrown: No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].

The opnum field value for this method is 10.

When processing this call the server MUST do the following:

  • Retrieve the certificate and cluster secret from storage in an implementation-specific manner.

  • If the certificate or cluster secret was not previously set by a call to ConfigClusterCert, the server MUST return 0x80070002 (ERROR_FILE_NOT_FOUND).

The server returns the certificate and cluster secret to the client.