Jump to content

SplEnable: Difference between revisions

From EDM2
Created page with "This function is called to enable the OS/2 spooler. ; Note: There is currently no support for using this API to remotely enable a print spooler. == Syntax == SplEnable(p..."
 
Ak120 (talk | contribs)
35,819 edits
mNo edit summary
 
Line 1: Line 1:
This function is called to enable the OS/2 spooler.  
This function is called to enable the OS/2 spooler.
 
;Note: There is currently no support for using this API to remotely enable a print spooler.


; Note: There is currently no support for using this API to remotely enable a print spooler.
== Syntax ==   
== Syntax ==   
  SplEnable(pszComputerName, pszDirectory,
  SplEnable(pszComputerName, pszDirectory, pReserved)
      pReserved);


== Parameters ==
== Parameters ==
;pszComputerName (PSZ) - input:Name of the computer on which to enable the spooler.
:This value currently must be NULL to enable the local spooler.
;pszDirectory (PSZ) - input:Name of the directory containing the spool files.
:This value must currently be set to NULL to use the spooler directory as defined in the SYSTEM INI file.
;pReserved (PVOID) - input:Must be NULL. Reserved for future use.


pszComputerName (PSZ) - input
;rc (ULONG) - returns: Return codes.
Name of the computer on which to enable the spooler.
::0 Success
 
::ERROR_INVALID_PARAMETER(87) An invalid buffer given.
This value currently must be NULL to enable the local spooler.
::PMERR_SPL_ALREADY_INITIALIZED(0x4FFD) The spooler is already enabled.
 
::PMERR_SPL_NO_MEMORY(0x4007) Not enough memory to enable spooler.
pszDirectory (PSZ) - input
Name of the directory containing the spool files.
 
This value must currently be set to NULL to use the spooler directory as defined in the SYSTEM INI file.
 
pReserved (PVOID) - input
Must be NULL. Reserved for future use.
 
== Returns ==
; rc (ULONG) - returns  
: Return codes.  
 
* 0 Success  
 
*ERROR_INVALID_PARAMETER(87)  
:An invalid buffer given.  
 
*PMERR_SPL_ALREADY_INITIALIZED(0x4FFD)  
:The spooler is already enabled.  
 
*PMERR_SPL_NO_MEMORY(0x4007)  
:Not enough memory to enable spooler.  
 
== Sample ==
<pre>
#define INCL_SPL
#define INCL_SPLBIDI
#include <os2.h>
 
PSZ      pszComputerName;  /*  Name of the computer on which to enable the spooler. */
PSZ      pszDirectory;    /*  Name of the directory containing the spool files. */
PVOID    pReserved;        /*  Must be NULL. Reserved for future use. */
ULONG    rc;              /*  Return codes. */
 
rc = SplEnable(pszComputerName, pszDirectory,
      pReserved);
 
</pre>


[[Category:Spl]]
[[Category:Spl]]

Latest revision as of 14:33, 13 December 2019

This function is called to enable the OS/2 spooler.

Note
There is currently no support for using this API to remotely enable a print spooler.

Syntax

SplEnable(pszComputerName, pszDirectory, pReserved)

Parameters

pszComputerName (PSZ) - input
Name of the computer on which to enable the spooler.
This value currently must be NULL to enable the local spooler.
pszDirectory (PSZ) - input
Name of the directory containing the spool files.
This value must currently be set to NULL to use the spooler directory as defined in the SYSTEM INI file.
pReserved (PVOID) - input
Must be NULL. Reserved for future use.
rc (ULONG) - returns
Return codes.
0 Success
ERROR_INVALID_PARAMETER(87) An invalid buffer given.
PMERR_SPL_ALREADY_INITIALIZED(0x4FFD) The spooler is already enabled.
PMERR_SPL_NO_MEMORY(0x4007) Not enough memory to enable spooler.
Retrieved from "https://www.edm2.com/index.php?title=SplEnable&oldid=68497"