IScheduler::SetCertificateCredentials method

Uploads a certificate in the client’s certificate store to the scheduler for running jobs as this user.

Syntax

HRESULT SetCertificateCredentials(
  [in] BSTR *userName,
  [in] BSTR *thumbprint
);

Parameters

• userName [in]
  The name of the RunAs user, in the form domain\user. The user name is limited to 80 characters.

• thumbprint [in]
  The thumbprint of the certificate to upload.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code. To get a description of the error, access the ISchedulerJob::ErrorMessage property.

Remarks

If userName is null or empty, the owner is treated as the user. Only SYSTEM on the cluster headnode is allowed to submit credentials as another user. To set the user as the owner, set username as either null or empty.

If thumbprint is null, the certificate store will be searched for relevant certificates. If there are multiple certificates, the user will be prompted to choose a password depending on the interface mode.

Requirements