Closes an identity handle that is used by the IDCRL to represent a service user account.

HRESULT CloseIdentityHandle(
       IN PassportIdentityHandle pihIdentity);


The identity handle to be closed.

S_OK. The identity handle was successfully closed.

Identity handles should be closed when they are no longer being used. If a client application creates multiple identity handles and does not close them when no longer needed, the client application will leak memory. After an identity handle has been closed, it cannot be used by any of the IDCRL methods. Identity handles are created by using the CreateIdentityHandle method.