SECidfGet
Function : ID vault
SECidfGet - Get the id file from the vault
#include <idvault.h>
STATUS FAR PASCAL SECidfGet(
char *pUserName,
char *pPassword,
char *pPutIDFileHere,
KFHANDLE *phKFC,
char *pServerName,
DWORD dwReservedFlags,
WORD wReservedType,
void *pReserved);
Will contact the server and locate a vault for pUserName. Then extract the ID file from the vault and write it to pPutIDFileHere, and/or open down loaded ID file into an hKFC, if successful returns with the vault server name in pServerName.
Parameters : Input : pUserName - Name of user whose ID is being put into vault - should be full Notes DN name.
pPassword - Password to id file being uploaded to the vault
pServerName - Name of server to contact - on successful return, name of server which has the vault,should point to a MAXUSERNAME length
dwReservedFlags - Reserved flag should be set to 0
wReservedType - Rserved type should be set to 0
Output : (routine) - An ERR status on failure indicating the problem.
pPutIDFileHere - Path to where the download ID file should be created or overwritten,may be NULL if phKFC is not NULL
phKFC - Pointer receive the hKFC of the ID file down loaded file from the vault,may be NULL if pPutIDFileHere is not NULL
pServerName - Name of server to contact - on successful return, name of server which has the vault,should point to a MAXUSERNAME length
Sample Usage :
// Get id file to local file name and hKFC
error = SECidfGet (UserName,
"2sherlock2",
"c:\\s2.id",
&hKFC2,
ServerName,
0,
0,
NULL);