GetProfileName

 

#include “BlackIceDEVMODE.h”

 

BOOL            GetProfileName (LPCTSTR szPrinterName, DWORD dwProfile , LPTSTR szProfileName, DWORD* dwBufSize);

Description

Returns the name of the profile specified in dwProfile. Use this function together with GetNumberOfProfiles, to enumerate the profiles. The numbering of the profiles is zero based (e.g. if GetNumberOfProfiles returns 5 you can retrieve the names of the profiles numbered from 0 to 4).

Parameters

LPCTSTR szPrinterName             - name of the Black Ice printer.

DWORD dwProfile                         - the number of the profile.

LPTSTR szProfileName               - the buffer that will receive the name of the profile.

DWORD* dwBufSize                     - pointer to a variable that contains the size of the buffer (in characters) szProfileName points to. If szProfileName is NULL, this variable receives the required buffer size in characters.

Return value

TRUE on success, otherwise FALSE.

Limitations

A 32 bit application that uses the 32 bit BlackIceDEVMODE.dll and ocx, must use the ApplyProfileFile function or method to change the profiles of 64 bit drivers. The rest of the Profile Manager Tab functions can only be used to change or retrieve the profiles of 32 bit drivers from 32 bit applications or to change or retrieve the profiles of 64 bit drivers from 64 bit applications.